تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إنشاء المهام في التطبيق

تتيح المهام في التطبيقات للمستخدمين تشغيل الوظائف في تطبيق Android من خلال توجيه طلب إلى "مساعد Google" أو استخدام اختصارات Android التي يقترحها "مساعد Google". في ما يلي الخطوات الأساسية لتوسيع نطاق تطبيق Android باستخدام "إجراءات التطبيق":

حدِّد الوظيفة داخل التطبيق التي تريد تفعيلها والهدف المضمّن (BII) المطابق لها.
قدِّم تفاصيل التسليم لملف BII.
إرسال الاختصارات لتنفيذ الإجراء على التطبيقات إلى "مساعد Google"
يمكنك معاينة "إجراءات التطبيقات" على جهاز اختبار.
أنشئ إصدارًا تجريبيًا من تطبيقك.
طلب مراجعة ميزة "الإجراءات داخل التطبيق" ونشرها

يمكنك اختياريًا تحديد اختصارات ديناميكية لتقديمها إلى "مساعد Google" كي يتمكّن من اقتراحها للمستخدمين. أنشئ "إجراء تطبيق" باستخدام نموذج تطبيق من خلال اتّباع الدرس التطبيقي حول ترميز "مهامّ في التطبيقات".

المتطلبات

قبل بدء تطوير "إجراءات التطبيقات"، تأكَّد من أنّك وتطبيقك تستوفيان المتطلبات التالية:

يجب أن يكون لديك حساب على Google يمكنه الوصول إلى Google Play Console.
يجب نشر تطبيقك على "متجر Google Play"، لأنّ "إجراءات التطبيقات" لا تتوفّر إلا للتطبيقات المنشورة هناك. تأكَّد أيضًا من أنّ تطبيقك غير مخصّص للاستخدام في ملف عمل، لأنّ "إجراءات التطبيق" غير متوافقة مع "Google Play للأعمال".
تحتاج إلى جهاز مادي أو افتراضي لاختبار خدمة "مهامّ في التطبيقات".
يجب تثبيت أحدث إصدار من استوديو Android.
يجب استخدام حساب Google نفسه لتسجيل الدخول إلى Android IDE وتطبيق Google على جهاز الاختبار وGoogle Play Console.
عليك إعداد "مساعد Google" على جهاز الاختبار واختباره عن طريق النقر مع الاستمرار على زر الشاشة الرئيسية.

مطابقة الأهداف المضمّنة مع وظائف التطبيق

حدِّد وظيفة تطبيق Android التي قد يرغب المستخدمون في الانتقال إليها من خلال طلب شفهي وراجِع مرجع intent المضمّن للعثور على مؤشرات BII المناسبة لحالات الاستخدام لديك. تمثّل BII طلبات بحث المستخدمين عن المهام التي يريدون تنفيذها، لذا ابحث عن معرّفات BII التي تطابق الوظائف الرئيسية ومسارات المستخدمين في تطبيقك.

هناك معرّفات BII شائعة يمكن لأي تطبيق Android تقريبًا استخدامها، مثل توسيع البحث داخل التطبيق ليشمل "مساعد Google" باستخدام actions.intent.GET_THING BII أو السماح للمستخدمين بإطلاق ميزات تطبيق محددة بصوتهم من خلال تنفيذ actions.intent.OPEN_APP_FEATURE BII.

هناك أيضًا معرّفات BII تتيح استخدام حالات الاستخدام المجالية أو الخاصة بفئة معيّنة. على سبيل المثال، قد يستخدم تطبيق التمارين الرياضية actions.intent.START_EXERCISE BII.

لضمان تقديم تجربة رائعة للمستخدمين وتجنُّب أي تأخيرات محتملة في الموافقة، احرص على أن يكون كل عنصر تفاعل تجاري داخل التطبيق مرتبطًا بوظائف التطبيق.

تعمل "إجراءات التطبيقات" من خلال بدء "نوايا Android" من تطبيق "مساعد Google" لنقل المستخدِمين مباشرةً إلى محتوى معيّن في تطبيقك. يمكنك تحديد النوايا لبدء نشاط بشكل صريح من خلال تحديد الحقلَين targetClass و targetPackage. إذا كان تطبيقك يستخدم حاليًا عناوين URL لروابط لصفحات في التطبيق على Android، يمكنك ضبط الإجراء لاستخدام رابط لصفحة في التطبيق بهدف تنفيذ الطلب. لمزيد من التفاصيل، يُرجى الاطّلاع على قسم اختبار الروابط المؤديّة إلى صفحات معيّنة في نشاطك.

تقديم تفاصيل عن عمليات الإنجاز للنوايا المضمّنة

في معظم مراحل إنشاء "مهمّة التطبيق"، يتم الإعلان عن الإمكانات في ملف مورد shortcuts.xml الخاص بتطبيق Android، حيث تحدّد نموذج BII المحدَّد وكيفية تنفيذه. ينشئ نموذج BII استعلام المستخدم عن مهمة، ويقدّم نموذج نية الإنجاز "مساعد Google" معلومات عن كيفية تنفيذ المهمة.

في ملف shortcuts.xml، يتم تمثيل معرّفات العملاء داخل المتجر على شكل عناصر <capability> ، ويتم تمثيل كل عملية توصيل على شكل عنصر <intent>:

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="exercise.name"
                android:key="exercise_name">
            </parameter>
        </intent>
    </capability>

في معظم طلبات البحث المتخصّصة، يمكنك استخراج مَعلمات النية من طلب بحث المستخدِم، وذلك استنادًا إلى عناصر schema.org. بعد ذلك، يستخدم تطبيقك مَعلمات BII هذه لتوجيه المستخدمين إلى الميزة المحدّدة. على سبيل المثال، يربط الرمز السابق المَعلمة exercise.name BII بالمَعلمة exercise_name Android intent.

إذا كنت تنفّذ الإجراءات باستخدام الروابط المؤدية إلى صفحات في التطبيق، يمكنك استخدام الحقل urlTemplate لتحديد عنوان URL لرابط صفحة معيّنة في التطبيق الذي ينشئه "مساعد Google":

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myexerciseapp://start{?exercise_name}" />
            <parameter android:name="exercise.name"
                android:key="exercise_name"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

ملاحظة: عندما يقدّم تطبيقك عدة نوايا لإكمال مهمة واحدة لملف تعريف برمجي موحّد، يحاول "مساعد Google" حلّها بالترتيب الذي تظهر به ضمن عنصر capability.

للاطّلاع على تفاصيل مهمة عن إضافة "إجراءات التطبيقات" إلى ملف shortcuts.xml، يُرجى الرجوع إلى مقالة إنشاء ملف shortcuts.xml. توضّح هذه الصفحة أيضًا كيفية تحديد قيم المَعلمات التي يتوقّعها تطبيقك.

تنفيذ الهدف المضمّن GET_THING

إذا كان تطبيقك يتضمّن وظيفة بحث، عليك تنفيذ ملف تعريف التفاعل البشري actions.intent.GET_THING لهذه الوظيفة. يمكن بعد ذلك لمساعد Google إعادة توجيه المستخدِمين إلى وظيفة البحث في تطبيقك للحصول على نتائج داخل التطبيق عندما يُجريون طلبات بحث، مثل "Ok Google، أريد البحث عن "مثال على شيء" في "مثال على تطبيق".

في ملف shortcuts.xml، نفِّذ <capability> لملف actions.intent.GET_THING BII كما تفعل عند تنفيذ أي ملف BII آخر. يمكنك استخدام عمليات إكمال متعددة لحالة العميل GET_THING طالما أنّك تقدّم عملية إكمال واحدة على الأقل تُرسِل طلب البحث العميل إلى وظيفة البحث في تطبيقك.

إليك مثال على إضافة actions.intent.GET_THING BII في shortcuts.xml:

  <capability android:name="actions.intent.GET_THING">
    <intent
      android:targetPackage="com.example.myapp"
      android:targetClass="com.example.myapp.MySearchActivity">
      <parameter android:name="thing.name" android:key="query" />
    </intent>
  </capability>

في عملية البحث Activity، استخرِج طلب البحث من البيانات الإضافية لملف العميل العميل intent واضبطه على وظيفة البحث في تطبيقك. في الرمز السابق، يرتبط طلب البحث، الذي يتم تمريره كمفتاح query، بالمَعلمة "thing.name" BII. بعد ذلك، يمكنك إجراء بحث باستخدام طلب البحث وعرض النتائج في واجهة المستخدم.

إجراء اختياري: إرسال الاختصارات لتنفيذ "مهمة التطبيق" إلى "مساعد Google"

بمجرد تحديد إمكانية إجرائك، يمكن للمستخدمين إطلاق إجرائك بقول عبارة مثل، "Hey Google، اطلب بيتزا على Example App." يمكن أن يقترح "مساعد Google" اختصارات Android للإجراءات التي تتّخذها للمستخدمين في الأوقات المناسبة، ما يتيح لهم اكتشاف إجراءاتك وإعادة تشغيلها. يمكن أن يقترح "مساعد Google" اختصارات ديناميكية وثابتة.

لإرسال الاختصارات الديناميكية إلى "مساعد Google"، يجب استخدام مكتبة دمج اختصارات Google. وتتيح مكتبة Jetpack هذه لخدمة "مساعد Google" استخدام الاختصارات واقتراحها للمستخدمين في الوقت المناسب.

لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إرسال الاختصارات الديناميكية إلى "مساعد Google".

معاينة "مهامّ في التطبيقات"

أثناء التطوير والاختبار، استخدِم مكوّن "مساعد Google" الإضافي في Android Studio لاختبار فعالية إجراءات التطبيقات في تطبيقك. ينشئ المكوّن الإضافي معاينة لإجراءات التطبيقات في "مساعد Google" لحسابك على Google. باستخدام أداة الاختبار، يمكنك اختبار عمليات التنفيذ على جهاز اختبار أو مُحاكي من خلال تزويد معرّفات BII بمعلمات الإدخال التي تتوقّع أن تتلقّاها من المستخدمين.

أثناء معاينة "إجراءات التطبيقات"، يمكنك تشغيل طلبات بحث باستخدام الصوت على الجهاز. لا تتوفّر هذه الوظيفة إلا للطلبات المدرَجة في ملف مرجع BII الخاص بإجراءات التطبيقات. استخدِم ميزة التشغيل الصوتي للتوضيح فقط وليس للاختبار العادي.

اختبِر تطبيقك في وضع المسودة باستخدام أدوات المطوّرين في Google Play Console قبل إرساله للمراجعة. لمزيد من المعلومات حول استخدام Google Play Console لنشر مسودة لتطبيقك، يُرجى الاطّلاع على مقالة إعداد إصدار وإطلاقه.

إنشاء إصدار تجريبي

عندما تكون مستعدًا لاختبار خدمة "مهامّ في التطبيقات" مع مختبِرين إضافيين، يمكنك إنشاء إصدار تجريبي داخلي أو مغلق من تطبيقك. ويمكن تلقائيًا لمختبِري الإصدارات الداخلية والمغلقة الوصول إلى خدمة "مهامّ في التطبيقات" التي سبق مراجعتها والموافقة عليها.

لمنح إمكانية الوصول إلى جميع "مهام التطبيق"، بما في ذلك المهام غير الموافَق عليها، اطلب من المختبِرين الانضمام إلى مجموعة Google الخاصة ببرنامج تطوير "مهام التطبيق". يمكن لأعضاء هذه المجموعة الوصول إلى جميع "إجراءات التطبيقات" في الإصدارات المغلقة والاختبارات الداخلية بدون الحاجة إلى إنشاء معاينات باستخدام أداة اختبار إجراءات التطبيقات. قد يستغرق الأمر ما يصل إلى ثلاث ساعات بعد الانضمام إلى المجموعة لتصبح إمكانية الوصول متاحة.

طلب مراجعة "الإجراءات داخل التطبيق" ونشرها

لا تتوفّر "إجراءات التطبيقات" لمستخدمي تطبيقاتك المنشورة أو إصدارات الاختبار المفتوح، وذلك إلى أن تتم مراجعتها والموافقة عليها. لا تؤثّر مراجعة "إجراءات التطبيق" في حالة مراجعة تطبيق Android ونشره على Google Play. حتى إذا تمت الموافقة على تطبيقك ونشره على "متجر Play"، قد يكون shortcuts.xml قيد المراجعة من قِبل Google. لا تعمل "إجراءات التطبيق" مع المستخدمين النهائيين إلى أن تتم الموافقة على هذه المراجعة أيضًا.

عند نشر تطبيقك، تظلّ "إجراءات التطبيق" مفعّلة. ومع ذلك، تخضع الإصدارات التي تمت إعادة نشرها للمراجعة من قِبل Google. إذا كان الإصدار الجديد لا يعمل بشكل صحيح أو يتضمّن انتهاكات للسياسات، تحتفظ Google بالحق في إيقاف ميزة "إجراءات التطبيق" في تطبيقك.

لإرسال خدمة "مهامّ في التطبيقات" للمراجعة، عليك اتّباع الخطوات التالية:

الموافقة على بنود خدمة "إجراءات التطبيقات" في Google Play Console (الإعدادات المتقدّمة > إجراءات التطبيقات):
حمِّل تطبيقك الذي يتضمّن shortcuts.xml إلى Google Play Console كالمعتاد لنشره.
بعد تحميل تطبيقك إلى Play Console، تتواصل معك Google على عنوان البريد الإلكتروني المدرَج في حسابك على Play Console لتقديم مزيد من المعلومات حول حالة مراجعة "الإجراء المتعلّق بالتطبيق". يمكنك أيضًا التواصل مع فريق دعم المطوّرين في "مساعد Google" لطرح أسئلة بشأن حالة مراجعة ميزة "إجراءات التطبيق". في ملف التواصل، أدخِل رقم تعريف حِزمة تطبيقك واختَر مراجعة إجراء التطبيق في المربّع لاختيار كيف يمكننا مساعدتك؟.

اختياري: اختبار الروابط لصفحات في التطبيق الخاصة بنشاطك

لاستخدام رابط لصفحة في التطبيق من أجل إطلاق Activity باستخدام "إجراء تطبيق"، يجب إعداد Activity باستخدام عناوين URL لروابط صفحات التطبيق وأن يكون لها فلتر أهداف مقابل في بيان تطبيق Android.

لاختبار إمكانية الوصول إلى أنشطتك ويمكن تنفيذها من خلال "إجراءات التطبيقات" باستخدام روابط لصفحات في التطبيق، شغِّل الأمر adb التالي:

$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

مثلاً:

$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

إذا لم يتم تشغيل نشاطك بشكل صحيح باستخدام الأمر adb، تحقَّق مما يلي:

في ملف بيان تطبيقك، يحتوي النشاط على android:exported=true، لذا يمكن بدءه باستخدام النوايا من "مساعد Google".
في حال استخدام عناوين URL الخاصة بروابط التطبيقات، اتّبِع جميع الخطوات الواردة في مقالة معالجة روابط تطبيقات Android.

سياسات "مهامّ في التطبيقات"

ويجب أن تكون خدمة "مهامّ في التطبيقات" متوافقة مع سياسات محدّدة للمساعدة في ضمان حصول المستخدمين الذين يفعِّلون هذه المهام على التجربة المطلوبة. يُرجى مراجعة هذه السياسات قبل إرسال تطبيقاتك لتوفير أفضل تجربة للمستخدم ولتجنُّب تأخير مراجعة "متجر Play" أو رفضها.

توجيه المستخدمين إلى المحتوى المخصّص لهم

يجب أن توجّه الأغراض المضمَّنة لإجراءات التطبيق (BII) و/أو المَعلمات المستخدمين فقط إلى الإجراء ذي الصلة الذي يصمّمه المستخدم. ويمكن أن يشمل ذلك المحتوى داخل التطبيق أو محتوى الموقع الإلكتروني أو المعلومات المعروضة في الشرائح أو التطبيقات المصغّرة طالما أنّه قد قصد المستخدم الاطّلاع على هذه التجربة.

على سبيل المثال، تساعد عمليات تنفيذ واجهة برمجة التطبيقات لقياس معدلات الأداء في START_EXERCISE المستخدمين في بدء تمرين من نوع معيّن، مثل الركض أو السباحة. إنّ الثناء الوحيد لهذه السياسة هو عندما يوجّه OPEN_APP_FEATURE BII المستخدمين إلى الشاشة الرئيسية لتطبيقك.
تنفيذ تقارير ذكاء الأعمال ذات الصلة بالإجراءات داخل التطبيق

يجب أن تكون ميزات BII التي تم تنفيذها مرتبطة مباشرةً بمحتوى التطبيق ووظائفه.

على سبيل المثال، إذا كان تطبيقك يندرج ضمن فئة "التواصل" في "متجر Play"، يجب عدم تنفيذ واجهة برمجة التطبيقات لبيانات اعتماد START_EXERCISE، والتي يُنصح باستخدامها في التطبيقات التي تندرج ضمن فئة "الصحة واللياقة".
تنفيذ شرائح الجمهور المخصّصة حسب النية بالشراء ذات الصلة

ترتبط طلبات البحث المحدّدة للأهداف المخصّصة بمحتوى التطبيق و وظيفته. على سبيل المثال، يتمثل أحد الانتهاكات المحتمَلة لهذه السياسة في إنشاء النية custom.action.intent.GET_RECIPE باستخدام نمط الطلب المرتبط "أريد اطّلاع على وصفات لفائف الفلفل الحار" لتطبيق في فئة "النقل" على "متجر Play".