Action

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

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

string

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

object (Fulfillment)

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

object (Intent)

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

string

وصف باللغة الإنجليزية لما يفعله الإجراء. يُستخدم هذا الإجراء بشكل أساسي ليتمكّن Google من مراجعة الإجراء أو لأغراض تصحيح الأخطاء. لن يظهر هذا الوصف للمستخدمين. يجب أن يتألف من أقل من 100 حرف ASCII.
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

يوضّح هذا الحقل ما إذا كان سيتم استخدام تنفيذ boxflow.

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

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

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

string

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

object (Parameter)

قائمة المعلمات داخل queryPatterns. يجب توفير كل المَعلمات ضمن queryPatterns.
trigger

object (Trigger)

مواصفات تشغيل هذا الغرض

المَعلمة

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

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

string

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

string

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

عامل التفعيل

مواصفات المشغِّل.

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

string

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