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

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

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

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

المتطلبات

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

  • يجب أن يكون لديك حساب Google لديه إمكانية الوصول إلى Google Play Console
  • يجب نشر تطبيقك على "متجر Google Play" لأنّ ميزة "مهامّ في التطبيقات" هي متاحة فقط للتطبيقات التي يتم نشرها هناك. تأكد أيضًا من أن تطبيقك غير مخصص للاستخدام في ملف العمل، إذ لا تتوفر خدمة "مهامّ في التطبيقات" بواسطة "Google Play للأعمال".
  • تحتاج إلى جهاز مادي أو افتراضي لاختبار خدمة "مهامّ في التطبيقات".
  • يجب استخدام أحدث إصدار من استوديو Android.
  • يجب استخدام حساب Google نفسه لتسجيل الدخول إلى Android "استوديو YouTube" وتطبيق 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 3-

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

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

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

تشير معظم مراحل إنشاء "مهمة تطبيق" إلى إحدى الإمكانات في ملف المصدر shortcuts.xml الخاص بتطبيق Android الذي تم تحديد BII الذي اخترته وتنفيذه المقابل له. يصمم A 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، يمكنك استخراج مَعلمات intent من طلب بحث المستخدم. استنادًا إلى كيانات 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".

في ملف 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 وحدة التحكّم قبل إرسال التطبيق للمراجعة. لمزيد من المعلومات عن استخدام 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، وبالتالي يمكن باستخدام الأهداف من "مساعد Google".
  • في حال استخدام عناوين URL لروابط التطبيقات، اتّبِع جميع الخطوات الواردة في التعامل مع ميزة Android App Links:

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

يجب أن تمتثل خدمة "مهامّ في التطبيقات" لسياسات محدّدة للمساعدة في ضمان أنّ المستخدمين الذين وجعله يتلقى التجربة المقصودة. يُرجى مراجعة هذه السياسات قبل إرسال تطبيقاتك لتقديم أفضل تجربة للمستخدم ولتجنُّب Google 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 ذات الصلة لمهام التطبيقات

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

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

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

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