رابط إلى الإجراءات (Dialogflow)

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

في ما يلي بعض الأمثلة على الروابط المفيدة لخدمة "مساعد Google":

• ربط المستخدمين بتعليمات صوتية من موقع إلكتروني لطريقة التنفيذ.
• ربط المستخدمين بتجربة دعم العملاء من صفحة "الحصول على مساعدة"
• ربط المستخدمين بهدف التحديث حتى يتمكنوا من تفعيل تحديثاتك المستقبلية.

ملاحظة: تختلف روابط "مساعد Google" عن روابط الويب للدليل التي ترسل المستخدم إلى صفحة "الدليل".

لإنشاء عنوان URL لأحد الإجراءات، قم بما يلي:

1. في وحدة تحكّم الإجراءات، انتقِل إلى التطوير > الإجراءات.
2. انقر على الإجراء الذي تريد إنشاء رابط له.
3. ضمن قسم الروابط، فعِّل الخيار هل تريد تفعيل عنوان URL لهذا الإجراء.
4. أدخِل عنوان الرابط. يجب أن يشتمل هذا العنوان على فعل يصف ما سيفعله الإجراء. على سبيل المثال، إذا كان الإجراء الخاص بك ينقل المستخدم إلى مسار المعاملات لشراء تذاكر حفلة موسيقية، سيكون عنوان الرابط المفيد هو "شراء تذاكر الحفلات الموسيقية".
5. انقر على حفظ.

يمكنك نسخ عنوان URL المقدَّم والرجوع إليه أينما أردت توجيه المستخدمين إلى هذا الإجراء المحدّد.

ملاحظة: في حال تفعيل رابط "مساعد Google" بعد نشر الإجراء الخاص بك، عليك إعادة نشر الإجراء حتى يتم تفعيل الرابط.

مَعلمات رابط "مساعد Google"

يمكن أن تحتوي روابط "مساعد Google" اختياريًا على هدف ومَعلمات في عنوان URL. وتعالج Google المعلَمات وفقًا لنوع الغرض المحدّد في عنوان URL.

مواصفات عنوان URL لرابط "مساعد Google"

في ما يلي البنية العامة لعنوان URL لرابط "مساعد Google":

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$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&param.astrologySign=%22cancer%22

عناوين URL لروابط "مساعد Google" تتضمّن أغراضًا مخصّصة

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

يوضّح المثال التالي كيفية تحديد عنوان URL لرابط إلى "مساعد Google" يتضمّن غرضًا مخصّصًا:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.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":

1. تفعيل رابط "مساعد Google" في وحدة التحكّم
2. سجِّل الدخول إلى "مساعد Google" باستخدام الحساب نفسه الذي استخدمته لإنشاء مشروع "المهام مع مساعد Google".
3. إنشاء نسخة قابلة للنقر من رابط "مساعد Google" (في البريد الإلكتروني، المحادثة، المستند، إلخ).
4. على جهاز مزوّد بخدمة "مساعد Google"، انقر على الرابط الذي تم إنشاؤه في الخطوة السابقة.

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

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

القيود وأفضل الممارسات

بما أنّه يمكن الآن توزيع عنوان URL لرابط "مساعد Google" والإشارة إليه خارج الدليل أو خدمات Google الأخرى، يُرجى العِلم أنّ القيود وأفضل الممارسات التالية تنطبق:

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

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

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