Action

הפעולה מייצגת אינטראקציה ספציפית שנתמכת על ידי פרויקט הפעולות שלך. האינטראקציה יכולה להיות יחידה בודדת או כמה שלבים.

ייצוג JSON 
{
  "name": string,
  "fulfillment": {
    object (Fulfillment)
  },
  "intent": {
    object (Intent)
  },
  "description": string,
  "signInRequired": boolean,
  "source": string
}
שדות
name

string

שם הפעולה. צריך לציין שם גם אם משתמשים ב-Intent נפוץ לפעולה ב-Google (שמתחילה ב-'actions'). לדוגמה, אם משתמשים ב-Intent 'actions.intent.MAIN', שם הפעולה לפי המוסכמה הוא 'MAIN'. חבילות פעולה צריכות להצהיר על פעולה אחת לפחות.
fulfillment

object (Fulfillment)

איך לבצע את הפעולה הזו.
intent

object (Intent)

כוונה שהפעולה הזו ממומשת. שמות של פעולות נפוצות באובייקטים מסוג Intent ב-Google מתחילים ב-'actions'. חבילות פעולות לנציגים בשיחות חייבות לכלול אובייקט Intent בשם 'actions.intent.MAIN'. למידע נוסף: https://developers.google.com/actions/reference/rest/intents
description

string

תיאור באנגלית של הפעולה. משמש בעיקר כדי ש-Google תבדוק את הפעולה או למטרות ניפוי באגים. התיאור הזה לא יוצג למשתמשים. היא חייבת לכלול פחות מ-100 אותיות ASCII.
signInRequired

boolean

שדה זה מציין אם נדרשת כניסה לפעולה זו. חשוב לשים לב שאפשרות זו תקפה רק כאשר לאובייקט ActionPackage מצוין המאפיין AccountLinking.
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. יכול להיות אובייקט Intent מובנה, שמתחיל ב-actions.. במצב כזה הפרמטרים ודפוסי השאילתה משתמעים ולכן המערכת מתעלמת מהם.
parameters[]

object (Parameter)

רשימת הפרמטרים בתוך queryPatterns. יש לספק את כל הפרמטרים בתוך queryPatterns.
trigger

object (Trigger)

הפעלת המפרט עבור ה-Intent הזה.

פרמטר

פרמטר שנעשה בו שימוש ברכיבי pattterns של שאילתה. זהו ייצוג מובנה של הפרמטרים בתבניות השאילתה (למשל $Color:color).

ייצוג JSON 
{
  "name": string,
  "type": string
}
שדות
name

string

שם הפרמטר, למשל color.
type

string

סוג הפרמטר. יכול להיות סוג נפוץ או סוג מותאם אישית שהוצהר כחלק מחבילת הפעולות. למשל: Color.

Trigger

מפרט לטריגר.

ייצוג JSON 
{
  "queryPatterns": [
    string
  ]
}
שדות
queryPatterns[]

string

רשימת הדפוסים המשמשים לזיהוי הכוונה שצוינה. דפוסי השאילתה חייבים להתייחס רק לפרמטרים שהוצהרו בשדה הפרמטרים.