إنّ الأغراض المضمّنة (BII) تسمح لتطبيقك بالتعبير عن إمكاناته المطلوبة لـ Google. من خلال الإعلان عن الإمكانات في ملف short.xml وربط معلَمات الأهداف بعملية التنفيذ، تتيح لمساعد Google تشغيل تطبيقك على شاشة محدّدة استجابةً لطلب بحث، ما يتيح للمستخدم إكمال مهمة.
يتم تجميع الأهداف المضمّنة وفقًا لفئات التطبيقات. تمثل كل فئة مجموعة من المهام الشائعة التي يريد المستخدمون إجراؤها بشكل متكرر على تطبيقاتهم. تتوفّر القائمة الكاملة لمعرّفات BII المتاحة ومَعلماتها ونماذج طلبات البحث القابلة للاستخدام للاختبار في مرجع الغرض المضمَّن.
تمتلك العديد من BII متطلبات نشر وتوصيات محددة. تساعد هذه المتطلبات والاقتراحات تطبيقك على تقديم أفضل تجربة ممكنة للمستخدمين.
![](https://developer.android.com/static/guide/app-actions/images/Fitness1.png?authuser=6&hl=ar)
START_EXERCISE
BII من خلال طلب
صوتي إلى "مساعد Google".![](https://developer.android.com/static/guide/app-actions/images/Fitness3.png?authuser=6&hl=ar)
START_EXERCISE
.![](https://developer.android.com/static/guide/app-actions/images/Fitness4-widget.png?authuser=6&hl=ar)
تنفيذ معرّفات BII والتعامل مع مَعلمات الأهداف
بالنسبة إلى "مهامّ في التطبيقات"، عليك توضيح الإمكانات والتعامل مع مَعلمات BII في ملف short.xml. لتنفيذ BII والتعامل مع معاملاته، اتبع الخطوات التالية:
- يمكنك تعريف
capability
باستخدام العنصر BII الذي تم اختياره. - أضِف عناصر
parameter
مدمجة لكل حقل BII تريد إضافته.- إذا استخدمت
targetClass
أوtargetPackage
، اربطهما بطلب Androidextras
باستخدام اسم من اختيارك. - إذا كنت تستخدِم عنوان URL لرابط صفحة معيّنة في التطبيق، استخدِم المَعلمات المُسمّاة في سلسلة طلب البحث لنموذج عنوان URL.
- إذا استخدمت
للتعامل مع مَعلمة BII، اربط المَعلمة BII بالمَعلمة المقابلة لهدف Android صريح في capability
.
بعد ذلك، يمكنك استخدام قيمته في تطبيقك، ولكن لا يُشترَط على تطبيقك التعامل مع مَعلمات BII. ومع ذلك، حاول معالجة حقول البيانات التي تم وضع علامة "مقترَحة" عليها في مرجع الغرض المضمَّن.
يمكنك تحديد عمليات تنفيذ أهداف متعددة، ولكل منها مجموعة خاصة من المَعلمات المقترَحة. تختار Google طريقة التنفيذ المناسبة استنادًا إلى معلَمات القدرة التي تحدّدها من طلب بحث المستخدم وتلك المعرَّفة في intent.
على سبيل المثال، يقترح هدف actions.intent.START_EXERCISE
أن يتعامل تطبيقك مع معلَمة exercise.name
BII، ولكن يمكنك تنفيذ BII في تطبيقك بدون أي معلَمات.
يمكنك القيام بذلك إذا كنت تريد التعامل مع طلبات بحث المستخدمين بدون اسم
التمرين المحدد، مثل "اطلب من تطبيق Example بدء تتبع التمرين".
يحتوي المقتطف التالي على إجراء احتياطي لعملية تنفيذ بدون معلمات مطلوبة في حال عدم تضمين المعلمات في طلب بحث المستخدم:
<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
<capability android:name="actions.intent.START_EXERCISE">
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.example.myapplication.Activity1"
android:targetPackage="com.example.myapplication">
<parameter
android:name="exercise.name"
android:key="exerciseType"
android:required="true"
/>
</intent>
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.example.myapplication.Activity2">
</intent>
</capability>
</shortcuts>
يبذل "مساعد Google" قصارى جهده لتقديم المعلومات الأكثر صلة للمستخدم عند عرض قيم المعلَمات إلى تطبيقك. على سبيل المثال، لا تتضمّن طلبات بحث المستخدمين عن طلب البيتزا من تطبيق Example Restaurant موقعًا جغرافيًا دائمًا. ولخدمة المستخدم بشكل أفضل، قد يوفّر "مساعد Google" قيم خطوط الطول والعرض في أقرب مطعم مستوحى من هذا التطبيق.
كشرط إضافي، يجب ألا ينفّذ تطبيقك إجراءً يؤدي إلى تعديل الحالة الواقعية للمستخدم (مثل تحويل الأموال أو تقديم طلب أو إرسال رسالة) بدون تأكيد الإجراء مع المستخدم أولاً.
التوضيح
قد لا تحدِّد الوسيطات التي يتم تمريرها إلى تطبيقك عبر <url-parameter>
أو الإضافات المستندة إلى النية بشكل فريد العنصر الذي تريد عرضه للمستخدم. في هذه الحالة، استخدِم قيمة الوسيطة كوسيطة بحث وانقل المستخدم إلى صفحة البحث في التطبيق. ويمكنها إزالة الغموض واختيار العنصر المناسب.
على سبيل المثال، إذا كان طلب بحث المستخدم هو "الطلب من مطعم كبير" لـ
ORDER_MENU_ITEM
BII، يمكنك أن تقدّم للمستخدم قائمة
بالمطاعم التي تتطابق أسماؤها مع العبارة "Example Restaurant"
.
دعم اللغة
يتم إدراج اللغات المتاحة للتطوير والاختبار من خلال كل إجراء تطبيق BII في مرجع الغرض المضمّن. وتعتمد بعض معرّفات BII على لغات مختلفة لاختبار مطوّري البرامج وللتشغيل الذي يُجريه المستخدم من خلال "مساعد Google".