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

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

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

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

الشروط

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

  • يجب أن يكون لديك حساب على Google يمكنه الوصول إلى Google Play Console.
  • يجب نشر تطبيقك في "متجر 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.

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

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

تقديم تفاصيل تنفيذ الطلبات للأهداف المضمّنة

في معظم مراحل إنشاء "مهمّة في التطبيق"، يتم تحديد الإمكانية في ملف الموارد shortcuts.xml في تطبيق 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 لرابط صفحة معيّنة في التطبيق الذي ينشئه مساعد Google:

<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 App".

في ملف 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 لنشر مسودة لتطبيقك، يمكنك الاطّلاع على إعداد إصدار وطرحه.

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

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

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

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

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

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

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

  1. وافِق على بنود خدمة "المهام مع مساعد Google" في أداة Google Play Console (الإعدادات المتقدمة > "المهام مع مساعد Google"):

    بنود خدمة &quot;المهام مع مساعد Google&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".

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

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

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

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

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

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

  • تنفيذ مؤشرات أداء الأعمال ذات الصلة في التطبيقات

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

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

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

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