Action

Action نشان دهنده یک تعامل خاص است که پروژه اقدامات شما از آن پشتیبانی می کند. این تعامل می تواند تک شات یا چند مرحله ای باشد.

نمایندگی JSON
{
  "name": string,
  "fulfillment": {
    object (Fulfillment)
  },
  "intent": {
    object (Intent)
  },
  "description": string,
  "signInRequired": boolean,
  "source": string
}
زمینه های
name

string

نام اقدام حتی اگر از یک اقدام مشترک در Google intent استفاده می‌کنید (با «اقدامات» شروع می‌شود، باید یک نام ارائه کنید. به عنوان مثال، اگر از هدف "actions.intent.MAIN" استفاده می کنید، نام Action بر اساس قرارداد "MAIN" است. بسته های اقدام باید حداقل یک اقدام را اعلام کنند.

fulfillment

object ( Fulfillment )

نحوه اجرای این Action

intent

object ( Intent )

هدفی که این اقدام محقق می کند. نام‌های مربوط به اهداف مشترک Action on Google با «اقدامات» شروع می‌شود. بسته‌های اقدام برای عوامل مکالمه باید دارای یک هدف با نام "actions.intent.MAIN" باشند. به https://developers.google.com/actions/reference/rest/intents مراجعه کنید

description

string

توضیحات انگلیسی آنچه که Action انجام می دهد. این عمدتاً برای Google برای بازبینی Action یا برای اهداف اشکال‌زدایی استفاده می‌شود. این توضیحات به کاربران نشان داده نخواهد شد. باید کمتر از 100 حرف ASCII باشد.

signInRequired

boolean

نشان می دهد که آیا ورود به سیستم برای این اقدام لازم است یا خیر. توجه داشته باشید که این فقط زمانی معتبر است که شی ActionPackage دارای ویژگی AccountLinking باشد.

source
(deprecated)

string

یک شناسه رشته برای ابزاری که این Action را ایجاد کرده است

تحقق

نحوه اجرای یک عمل

نمایندگی 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

این فیلد نشان می دهد که آیا باید از انجام دیالوگ فلو استفاده کرد یا خیر.

قصد

Intent و الگوهای پرس و جو مرتبط با آن که برای مطابقت با پرس و جوهای کاربر استفاده می شود. برای تحریک اولیه استفاده می شود.

نمایندگی JSON
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
زمینه های
name

string

نام این هدف را نشان می دهد، به عنوان مثال، BOOK_A_TABLE . می تواند یک هدف داخلی باشد که با actions. ، در این حالت پارامترها و الگوهای پرس و جو به طور ضمنی وجود دارد و بنابراین نادیده گرفته می شود.

parameters[]

object ( Parameter )

لیست پارامترهای درون queryPatterns. تمام پارامترهای درون queryPattern باید داده شوند.

trigger

object ( Trigger )

تعیین مشخصات برای این هدف.

پارامتر

پارامتری که در الگوهای پرس و جو استفاده می شود. این یک نمایش ساختار یافته از پارامترها در queryPatterns است (به عنوان مثال $Color:color ).

نمایندگی JSON
{
  "name": string,
  "type": string
}
زمینه های
name

string

نام پارامتر، به عنوان مثال color .

type

string

نوع پارامتر می تواند یک نوع معمول یا نوع سفارشی باشد که به عنوان بخشی از بسته اکشن اعلام شده است، به عنوان مثال Color .

ماشه

مشخصات یک ماشه

نمایندگی JSON
{
  "queryPatterns": [
    string
  ]
}
زمینه های
queryPatterns[]

string

فهرست الگوهای مورد استفاده برای شناسایی هدف مشخص شده. الگوهای پرس و جو فقط باید به پارامترهای اعلام شده در قسمت پارامترها اشاره کنند.