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

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

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

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

تنبيه: بسبب القيود التنظيمية، قد تعمل التطبيقات المشارِكة في برنامج لا يُسمح باستخدام ميزة "مهامّ في التطبيقات" في برنامج "المهام المخصّصة للعائلات" (DFF). في حال إرسال إجراء التطبيق للمراجعة بشأن أحد التطبيقات المدرجة في برنامج DFF، ولا يمكن الموافقة عليها.

المتطلبات

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

• يجب أن يكون لديك حساب 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.

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

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

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

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

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

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

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

في ملف shortcuts.xml، يتم تمثيل معرّفات BII على النحو التالي: <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>

ملاحظة: يجب توفُّر مكتبة Jetpack androidx.core:core:1.6.0 (أو الإصدارات الأحدث) في جهاز Android. لتجنب أخطاء التجميع عند تحديد إمكانات مهام التطبيق في shortcuts.xml لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة بدء استخدام Android Jetpack.

بالنسبة إلى معظم معرّفات BII، يمكنك استخراج مَعلمات intent من طلب بحث المستخدم. استنادًا إلى كيانات 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 BII لهذه الدالة. يمكن بعد ذلك لمساعد 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"

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

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

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

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

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

ملاحظة: يمكنك أيضًا إضافة مختبِرين آخرين لخدمة "مهامّ في التطبيقات". عملية الدمج، حتى إذا لم يتشاركوا في حساب Play Console نفسه. إلى معرفة المزيد، راجع أضِف مختبِرين آخرين.

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

ملاحظة: لا تتوافق أداة اختبار "الإجراءات في التطبيقات" إلا مع اختبار معرّفات BII في ما لم يتم توفير أمثلة لطلبات بحث للغات أخرى في مرجع مضمّن مدمج.

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

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

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

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

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

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

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

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

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

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

   

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

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

ملاحظة: إذا تم حظر تطبيقك استنادًا إلى بيانات اعتماد تسجيل الدخول، يُرجى تقديم اختبار تسجيل الدخول من خلال إرسال التطبيق لتقديم بيانات اعتماد اختبارية، اختَر تطبيقك في Play Console، انتقل إلى السياسة > محتوى التطبيق، واتّبِع تم إدراج التعليمات حول الوصول إلى التطبيق.

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

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

ملاحظة: يمكن أن يستند الرابط لصفحة معيّنة في التطبيق إلى عناوين URL لروابط التطبيقات. عناوين URL مستندة إلى نية العميل أو مخططات مخصّصة، مثل myapp://do.thing/param=value.

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

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

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

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

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

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

• تنفيذ تقارير ذكاء الأعمال ذات الصلة بالإجراءات داخل التطبيق

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

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

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

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

---