Action

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

تمثيل JSON
{
  "name": string,
  "fulfillment": {
    object (Fulfillment)
  },
  "intent": {
    object (Intent)
  },
  "description": string,
  "signInRequired": boolean,
  "source": string
}
الحقول
name

string

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

fulfillment

object (Fulfillment)

كيفية تنفيذ هذا الإجراء

intent

object (Intent)

النية في أن يتم تنفيذ هذا الإجراء تبدأ أسماء الأهداف الشائعة في "المهام مع مساعد Google" بكلمة "إجراءات". يجب أن تحتوي حِزم الإجراءات لموظّفي الدعم الحواري على نية بالشراء باسم "actions.intent.MAIN". يُرجى الاطّلاع على https://developers.google.com/actions/reference/rest/intents.

description

string

تقدّم هذه السمة وصفًا باللغة الإنجليزية لوظيفة الإجراء. يُستخدَم هذا الإجراء بشكل أساسي لكي يراجع محرّك بحث Google الإجراء أو لأغراض تصحيح الأخطاء. لن يظهر هذا الوصف للمستخدمين. يجب ألا يزيد عدد أحرف ASCII عن 100 حرف.

signInRequired

boolean

تشير هذه السمة إلى ما إذا كان تسجيل الدخول مطلوبًا لهذا الإجراء. تجدر الإشارة إلى أنّ هذا الإجراء لا يكون صالحًا إلا إذا تم تحديد السمة AccountLinking في الكائن ActionPackage.

source
(deprecated)

string

معرّف سلسلة للأداة التي أنشأت هذا الإجراء

توصيل الطلبات

كيفية تنفيذ إجراء

تمثيل JSON
{

  // Union field conversation can be only one of the following:
  "conversationName": string,
  "useDialogflowFulfillment": boolean
  // End of list of possible types for union field conversation.
}
الحقول

حقل الاتحاد conversation.

يمكن أن يكون conversation واحدًا فقط مما يلي:

conversationName

string

تنفيذ إجراء من خلال تنفيذ محادثة يشير هذا إلى "الاسم" الحقل "Conversations" في الحقل ActionPackage.conversations.

useDialogflowFulfillment

boolean

يشير هذا الحقل إلى ما إذا كان يجب استخدام تنفيذ سير الحوار.

النيّة بالشراء

الغرض وأنماط طلبات البحث المرتبطة به والتي تُستخدَم لمطابقة طلبات بحث المستخدم. يُستخدَم للتفعيل الأولي.

تمثيل JSON
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
الحقول
name

string

يشير إلى اسم هذا الغرض، على سبيل المثال BOOK_A_TABLE. يمكن أن يكون هدفًا مدمجًا، بدءًا من actions.، وفي هذه الحالة يتم تضمين المَعلمات وأنماط طلب البحث وبالتالي يتم تجاهلها.

parameters[]

object (Parameter)

قائمة المعلمات ضمن queryPatterns. يجب إعطاء جميع المعلمات ضمن queryPatterns.

trigger

object (Trigger)

تشغيل مواصفات هذا القصد

المعلمة

يشير ذلك المصطلح إلى معلَمة مستخدمة في أحرف طلب البحث. هذا تمثيل منظّم للمعلَمات في أنماط طلب البحث (مثل $Color:color).

تمثيل JSON
{
  "name": string,
  "type": string
}
الحقول
name

string

اسم المعلمة، مثل color

type

string

ونوع المعلمة. يمكن أن يكون نوعًا شائعًا أو نوعًا مخصّصًا مُعلَنًا عنه كجزء من حزمة الإجراءات، مثل: Color

عامل التفعيل

وصف عامل التشغيل.

تمثيل JSON
{
  "queryPatterns": [
    string
  ]
}
الحقول
queryPatterns[]

string

قائمة الأنماط المستخدَمة لتحديد الغرض المحدّد ويجب أن تشير أنماط طلب البحث إلى المَعلمات المعلَنة في حقل المَعلمات فقط.