يمكنك إنشاء عنوان URL يرتبط مباشرةً بالإجراء المحدّد، على أساس كل إجراء. عندما ينقر المستخدمون على رابط "مساعد Google" (المعروفة سابقًا باسم "روابط الإجراءات") في متصفّح الويب أو الأجهزة الجوّالة، سيتم توجيههم إلى "مساعد Google" على أجهزتهم، حيث سيتفاعلوا مباشرةً مع الإجراء المقابل.
في ما يلي بعض الأمثلة على الروابط المفيدة لخدمة "مساعد Google":
- ربط المستخدمين بتعليمات صوتية من موقع إلكتروني لطريقة التنفيذ.
- ربط المستخدمين بتجربة دعم العملاء من صفحة "الحصول على مساعدة"
- ربط المستخدمين بهدف التحديث حتى يتمكنوا من تفعيل تحديثاتك المستقبلية.
لإنشاء عنوان URL لأحد الإجراءات، قم بما يلي:
- في وحدة تحكّم الإجراءات، انتقِل إلى التطوير > الإجراءات.
- انقر على الإجراء الذي تريد إنشاء رابط له.
- ضمن قسم الروابط، فعِّل الخيار هل تريد تفعيل عنوان URL لهذا الإجراء.
- أدخِل عنوان الرابط. يجب أن يشتمل هذا العنوان على فعل يصف ما سيفعله الإجراء. على سبيل المثال، إذا كان الإجراء الخاص بك ينقل المستخدم إلى مسار المعاملات لشراء تذاكر حفلة موسيقية، سيكون عنوان الرابط المفيد هو "شراء تذاكر الحفلات الموسيقية".
- انقر على حفظ.
يمكنك نسخ عنوان URL المقدَّم والرجوع إليه أينما أردت توجيه المستخدمين إلى هذا الإجراء المحدّد.
مَعلمات رابط "مساعد Google"
يمكن أن تحتوي روابط "مساعد Google" اختياريًا على هدف ومَعلمات في عنوان URL. وتعالج Google المعلَمات وفقًا لنوع الغرض المحدّد في عنوان URL.
مواصفات عنوان URL لرابط "مساعد Google"
في ما يلي البنية العامة لعنوان URL لرابط "مساعد Google":
https://assistant.google.com/services/invoke[/$action_id][?intent=$intent¶m.$param=$value][&$utm_param=$utm_value]
يتمّ توضيح مَعلمات عناوين URL التي يمكنك ضبطها في الجدول التالي:
معلمة عنوان URL | الوصف |
---|---|
$action_id |
المعرّف الرقمي للإجراء |
$intent |
الاسم الكامل للنوع المضمّن أو المخصص حسب النية بالشراء. |
$param |
الاسم الكامل لمعلَمة الغرض المحدّدة في حزمة الإجراءات. |
$value |
قيمة مشفّرة لعنوان URL من النوع الذي تم تعريفه للنوع $param في حزمة الإجراءات. |
$utm_param |
قائمة تتضمّن نوع أو أكثر من أنواع مَعلمات نظام مراقبة الزيارات من Urchin وتشمل القيم الصالحة:
utm_source وutm_medium
وutm_campaign وutm_term
وutm_content . |
$utm_value |
قيمة سلسلة لمَعلمة نظام مراقبة الزيارات من Urchin |
عناوين URL لروابط "مساعد Google" تتضمّن أغراضًا مدمجة
إذا كان رابط "مساعد Google" يحتوي على
هدف مضمّن (الغرض يبدأ بـ actions.intent.*
)، ستحاول Google استخراج أي مَعلمات مضمّنة في عنوان URL ونقلها إلى الإجراء الخاص بك. وتتم إزالة أي مَعلمات لا يتعرّف عليها محرّك بحث Google على أنّها مَعلمات الغرض المضمّنة.
بالنسبة إلى "الإجراءات القائمة على المحادثة"، ترسل Google هذه المَعلمات إلى عملية التنفيذ كجزء من رسالة AppRequest
.
يوضّح المثال التالي كيفية تحديد عنوان URL لرابط إلى "مساعد Google" يتضمن هدفًا مضمّنًا مع معلَمة هدف واحدة:
https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE¶m.astrologySign=%22cancer%22
عناوين URL لروابط "مساعد Google" تتضمّن أغراضًا مخصّصة
بالنسبة إلى الأغراض المخصّصة حسب النية بالشراء، لا تستخرج Google سوى تلك المَعلمات التي يتم تحديدها في الإجراء الخاص بك كجزء من الغرض، وتتجاهل أي مَعلمات أخرى.
يوضّح المثال التالي كيفية تحديد عنوان URL لرابط إلى "مساعد Google" يتضمّن غرضًا مخصّصًا:
https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK¶m.topic=sports
بالنسبة إلى مثال عنوان URL أعلاه، في AppRequest
، يضيف Google كائن JSON على النحو التالي:
argument {
name: ‘topic’,
raw_text: ‘sports’,
text_value: ‘sports’,
}
عناوين URL لروابط "مساعد Google" التي لا تتضمّن أغراضًا
إذا لم تحدّد هدفًا في رابط "مساعد Google"، ستضع Google رابطًا يؤدّي إلى هدف MAIN
(actions.intent.MAIN
) في الإجراء الخاص بك تلقائيًا باتّباع السلوك التالي:
- إذا لم يتم تفعيل هدف
MAIN
بشكل صريح في رابط "مساعد Google"، ستفعّل Google الغرض الرئيسي بدون أي معلَمات، تمامًا مثل سلوك "التحدّث إلى app_name". - في حال تفعيل هدف
MAIN
بشكل واضح، ستمرر Google المعلَمات إلى الإجراءات الخاصة بك.
يوضّح المثال التالي كيفية تحديد عنوان URL لرابط إلى "مساعد Google" بدون هدف:
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4
عناوين URL لرابط "مساعد Google" مع مَعلمات نظام مراقبة الزيارات من Urchin
مَعلمات نظام مراقبة الزيارات من Urchin هي سلاسل ترسلها Google إلى الإجراء الخاص بك عندما ينقر المستخدِمون على رابط مع "مساعد Google"، ويمكنك استخدام هذه السلاسل لاحقًا لإجراء الإحصاءات.
تتضمن معلَمات نظام مراقبة الزيارات من Urchin التي ترسلها Google إلى الإجراء الخاص بك ما يلي:
utm_source
utm_medium
utm_campaign
utm_term
utm_content
يوضّح المثال التالي كيفية تحديد عنوان URL لرابط إلى "مساعد Google" يتضمّن مَعلمات نظام مراقبة الزيارات من Urchin:
https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale
بالنسبة إلى مثال عنوان URL أعلاه، تضيف Google الوسيطات التالية في الرسالة AppRequest
:
argument {
name: ‘utm_source’,
raw_text: ‘Google’,
text_value: ‘Google’,
}
argument {
name: ‘utm_medium’,
raw_text: ‘email’,
text_value: ‘email’,
}
argument {
name: ‘utm_campaign’,
raw_text: ‘holiday sale’,
text_value: ‘holiday sale’,
}
روابط "مساعد Google" التجريبي
يمكنك اختبار روابط "مساعد Google" لأي غرض (أساسي أو مخصّص، سواء كان يتضمّن معلَمات أو بدونها) من خلال المحاكي أو أحد الأجهزة.
لاختبار رابط "مساعد Google":
- تفعيل رابط "مساعد Google" في وحدة التحكّم
- سجِّل الدخول إلى "مساعد Google" باستخدام الحساب نفسه الذي استخدمته لإنشاء مشروع "المهام مع مساعد Google".
- إنشاء نسخة قابلة للنقر من رابط "مساعد Google" (في البريد الإلكتروني، المحادثة، المستند، إلخ).
- على جهاز مزوّد بخدمة "مساعد Google"، انقر على الرابط الذي تم إنشاؤه في الخطوة السابقة.
بعد التأكّد من أنّ رابط "مساعد Google" يعمل على النحو المتوقّع، سيكون عليك إعادة نشر الإجراء الخاص بك لإتاحة الرابط للمستخدمين.
القيود وأفضل الممارسات
بما أنّه يمكن الآن توزيع عنوان URL لرابط "مساعد Google" والإشارة إليه خارج الدليل أو خدمات Google الأخرى، يُرجى العِلم أنّ القيود وأفضل الممارسات التالية تنطبق:
- احرص على مواصلة إتاحة كل روابط "مساعد Google" الخاصة بك. إذا وزّعت رابط "مساعد Google" يتوقّف في وقت لاحق، قد يتم وضع علامة على مشروع المهام الخاص بك بأنّه غير صحي وتمت إزالته.
ويعني نشر رابط أنّك توفّر إمكانية التشغيل من مصادر غير موثوق بها. بالنسبة إلى أيّ "إجراءات مرتبطة"، يجب التأكيد صراحةً مع المستخدم قبل اتخاذ أي "إجراء من واقع الحياة". على سبيل المثال، إذا كان الإجراء يوقِف تشغيل أجهزة منزلية ذكية، يجب أن يطلب من المستخدم قول "هل تريد فعلاً إيقاف
$applianceName
؟".وفي هذا السياق، يعني "الإجراء الواقعي" أي إجراء يؤثر في خدمات المستخدم أو بياناته أو أجهزته أو شبكاته أو أجهزة الكمبيوتر أو واجهات برمجة التطبيقات فيها. على سبيل المثال، إرسال رسالة إلكترونية أو إجراء معاملة أو تغيير حالة جهاز منزلي ذكي أو إنشاء اشتراك أو تعديل جزء من المحتوى.