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

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

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

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

الشروط

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

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

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

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

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

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

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

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

تقديم تفاصيل طريقة التنفيذ في الأغراض المضمَّنة

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

في ملف shortcuts.xml، يتم تمثيل BII كعناصر <capability>، ويتم تمثيل كل عملية تنفيذ كعنصر <intent>:

<shortcuts>
    <capability android:name="actions.intent.ORDER_MENU_ITEM">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="menuItem.name"
                android:key="query">
            </parameter>
        </intent>
    </capability>

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

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

<shortcuts>
    <capability android:name="actions.intent.ORDER_MENU_ITEM">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myfoodapp://browse{?query}" />
            <parameter android:name="menuItem.name"
                android:key="query"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

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

تنفيذ الغرض المضمَّن في GET_THING

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

في ملف 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"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. عليك قبول بنود خدمة "المهام في التطبيقات" في Google Play Console (الإعدادات المتقدمة > إجراءات التطبيقات):

    بنود خدمة &quot;المهام في التطبيقات&quot; في Google Play Console

  2. حمِّل تطبيقك الذي يتضمّن shortcuts.xml إلى Google Play Console كالمعتاد للنشر.

  3. بعد تحميل تطبيقك إلى 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، لذلك يمكن إطلاقه باستخدام عناصر intent من "مساعد Google".
  • إذا كنت تستخدم عناوين URL لروابط التطبيقات، اتّبِع جميع الخطوات الواردة في مقالة التعامل مع روابط تطبيقات Android.

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

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

  • توجيه المستخدمين إلى المحتوى الذي يستهدفه المستخدم

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

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

  • توجيه المستخدمين إلى محتوى ويب ذي صلة

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

    على سبيل المثال، تشكّل إعادة توجيه المستخدمين الذين يشغّلون GET_RESERVATION BII إلى google.com/travel التي لا تنتمي إلى العلامة التجارية exampledomain.com لتطبيقك انتهاكًا للسياسة. ومثال آخر على المخالفات هو إعادة توجيه المستخدمين الذين يشغّلون GET_CALL_HISTORY BII إلى exampledomain.com/payment ومطالبتهم بإجراء عملية شراء.

  • تنفيذ معرّفات BIS المحددة للإجراءات ذات الصلة في التطبيقات

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

    على سبيل المثال، إذا كان تطبيقك ضِمن فئة "متجر Play"، لا تنفِّذ ORDER_MENU_ITEM BII، وهي مُقترَحة للتطبيقات في فئة "الطعام والشراب".

  • تنفيذ أهداف مخصّصة حسب النية بالشراء

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