يمثل الإجراء تفاعلاً محددًا يدعمه مشروع الإجراءات. يمكن أن يكون التفاعل لقطة واحدة أو خطوات متعددة.
تمثيل JSON | |
---|---|
{ "name": string, "fulfillment": { object ( |
الحقول | |
---|---|
name |
اسم الإجراء. يجب توفير اسم حتى إذا كنت تستخدم أحد الإجراءات الشائعة في "المهام مع مساعد Google" (يبدأ بـ "الإجراءات"). على سبيل المثال، إذا كنت تستخدم الغرض actions.intent.MAIN، يكون اسم الإجراء حسب الاصطلاح هو MAIN. يجب أن تتضمّن حِزم الإجراءات إجراءً واحدًا على الأقل. |
fulfillment |
كيفية تنفيذ هذا الإجراء. |
intent |
الهدف الذي يحققه هذا الإجراء. تبدأ أسماء الأهداف الشائعة ضمن "المهام مع مساعد Google" بـ "الإجراءات". يجب أن تحتوي حِزم الإجراءات لوكلاء المحادثة على غرض بالاسم actions.intent.MAIN. يمكنك الاطّلاع على https://developers.google.com/actions/reference/rest/intents. |
description |
وصف باللغة الإنجليزية لما يفعله الإجراء. يُستخدم هذا الإجراء بشكل أساسي ليتمكّن Google من مراجعة الإجراء أو لأغراض تصحيح الأخطاء. لن يظهر هذا الوصف للمستخدمين. يجب أن يتألف من أقل من 100 حرف ASCII. |
signInRequired |
يشير هذا الحقل إلى ما إذا كان تسجيل الدخول مطلوبًا لتنفيذ هذا الإجراء. تجدر الإشارة إلى أنّ هذا الإجراء لا يكون صالحًا إلا إذا تم تحديد الخاصية AccountLinking في كائن ActionPackage. |
source |
معرّف سلسلة للأداة التي أنشأت هذا الإجراء |
توصيل الطلبات
كيفية تنفيذ إجراء ما.
تمثيل JSON | |
---|---|
{ // Union field |
الحقول | ||
---|---|---|
حقل الاتحاد يمكن أن تكون السمة " |
||
conversationName |
نفِّذ إجراءً من خلال تنفيذ محادثة. يشير هذا إلى حقل "الاسم" في |
|
useDialogflowFulfillment |
يوضّح هذا الحقل ما إذا كان سيتم استخدام تنفيذ boxflow. |
النيّة بالشراء
الهدف وأنماط طلبات البحث المرتبطة به والتي تُستخدم لمطابقة طلبات بحث المستخدم. ويتم استخدامه للتشغيل المبدئي.
تمثيل JSON | |
---|---|
{ "name": string, "parameters": [ { object ( |
الحقول | |
---|---|
name |
تشير إلى اسم هذا الغرض، مثل |
parameters[] |
قائمة المعلمات داخل queryPatterns. يجب توفير كل المَعلمات ضمن queryPatterns. |
trigger |
مواصفات تشغيل هذا الغرض |
المَعلمة
يشير ذلك المصطلح إلى معلَمة يتم استخدامها ضِمن أنماط طلب البحث. هذا تمثيل منظَّم للمعلَمات في queryPatterns (مثل $Color:color
).
تمثيل JSON | |
---|---|
{ "name": string, "type": string } |
الحقول | |
---|---|
name |
اسم المعلمة، مثل |
type |
ونوع المعلمة. يمكن أن يكون نوعًا شائعًا أو نوعًا مخصّصًا تم تعريفه كجزء من حزمة الإجراءات، مثل |
عامل التفعيل
مواصفات المشغِّل.
تمثيل JSON | |
---|---|
{ "queryPatterns": [ string ] } |
الحقول | |
---|---|
queryPatterns[] |
قائمة بالأنماط المستخدمة لتحديد الغرض المحدد يجب أن تشير أنماط طلب البحث إلى المعلَمات التي تم تعريفها في حقل المعلمات فقط. |