إنشاء نماذج الاستدعاء

يحدد نموذج الاستدعاء كيفية استدعاء المستخدمين للإجراءات في مشروعك. عندما يستدعي المستخدمون إجراءً معيّنًا، يبدأون محادثة معه، وهو ما يحدّده نموذج المحادثة. يمكنك تعريف الاستدعاءات بالطرق التالية:

  • الاستدعاء الرئيسي: هذا هو الاستدعاء الوحيد المطلوب لمشروع الإجراءات. يستخدم المستخدمون عبارة تشبه عبارة "Ok Google، أريد التحدث إلى <display name>" لمطابقة هذا الغرض، والتي تستخدمها عادةً من خلال الترحيب بالمستخدم من خلال رسالة ترحيب.

  • استدعاءات الروابط المؤدية إلى صفحات في التطبيق: هذه استدعاءات اختيارية تتيح لك تحديد عبارات تدريبية حسب النية بالشراء كي يتمكّن المستخدمون من إنشاء رابط لصفحة معيّنة في جزء معيّن من محادثتك. يمكن للمستخدمين قول عبارة تشبه "Ok Google، أريد التحدّث إلى <display name> to <deep link terms>" لمطابقة هذه الأنواع من النية (على سبيل المثال، "Ok Google, talk to Facts about Google to get company حقائق" ).

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

الشكل 1. يتألف نموذج الاستدعاء من جميع الأغراض المؤهّلة لبدء محادثات باستخدام الإجراءات الخاصة بك.

إنشاء الاستدعاء الرئيسي

يحتوي كل مشروع استدعاءات أساسية تلقائية تعمل كنقطة دخول تلقائية إلى مشروع "المهام". ويرتبط النموذج اللغوي لهذا الاستدعاء بالاسم المعروض لمشروعك، لذلك يحتاج المستخدمون فقط إلى قول عبارة تشبه "Ok Google، التحدّث إلى <display name>" لاستخدام هذا الاستدعاء. عندما يستدعي المستخدِمون "الإجراءات" بهذه الطريقة، يتطابق وقت تشغيل "مساعد Google" مع هدف النظام في actions.intent.MAIN.

لإنشاء الاستدعاء الرئيسي، يُرجى اتّباع الخطوات التالية:

لإنشاء استدعاءات روابط صفحات معيَّنة، يمكنك إنشاء نوايا مستخدم عمومية من خلال عبارات تدريب تحدّد البيانات التي يدخلها المستخدم والتي تريد ضبطها للرابط لصفحة معيّنة. يقول المستخدمون اسم العرض الخاص بك مع عبارة "رابط لصفحة في التطبيق" لتنفيذ استدعاء رابط لصفحة معيّنة (على سبيل المثال، "Ok Google، تحدَّث إلى <display name> to <deep link terms>").

إنشاء استدعاءات ضمنية

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

التعامل مع أحداث الاستدعاء

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

تشغيل ردّ تلقائي على الويب

يمكن لمعالِج الأهداف تفويض خدمة ويب من خلال بدء حدث الردّ التلقائي على الويب. لتفعيل ردّ تلقائي على الويب وضبط خدمة ويب لمعالجة الاستدعاء:

الطلبات

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

للتعامل مع مطابقة الغرض من الاستدعاء من خلال الطلب:

الانتقال إلى مشهد

ويمكن أن ينتقل معالج النية إلى مشهد لمعالجة النية المتطابقة للاستدعاء. يمنحك ذلك أكبر قدر من المرونة لتنفيذ المنطق. للانتقال إلى مشهد: