Action

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

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

string

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

fulfillment

object (Fulfillment)

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

intent

object (Intent)

הכוונה שהפעולה הזו ממלאת. שמות של פעולות נפוצות ב-Intents של 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

השדה הזה מציין אם להשתמש במילוי בקשה של תיבת דו-שיח.

כוונת רכישה

Intent ודפוסי השאילתות שמשויכים אליו, שמשמשים להתאמה לשאילתות של המשתמש. משמש להפעלה ראשונית.

ייצוג JSON
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
שדות
name

string

מציין את השם של הכוונה הזו, למשל, BOOK_A_TABLE. יכולה להיות Intent מובנה, שמתחיל ב-actions.. במקרה כזה, פרמטרים ודפוסי שאילתות מושמטים ולכן המערכת מתעלמת מהם.

parameters[]

object (Parameter)

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

trigger

object (Trigger)

המפרט להפעלת הכוונה הזו.

פרמטר

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

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

string

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

type

string

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

Trigger

מפרט לטריגר.

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

string

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