AppResponse

{
  "inputPrompt": {
    object (InputPrompt)
  },
  "possibleIntents": [
    {
      object (ExpectedIntent)
    }
  ],
  "speechBiasingHints": [
    string
  ]
}

object (InputPrompt)

ההנחיה המותאמת אישית שמשמשת כדי לבקש מהמשתמש להזין קלט.

object (ExpectedIntent)

רשימת כוונות שאפשר להשתמש בהן כדי למלא את הקלט הזה. כדי שפעולות ב-Google יחזירו רק את הקלט הגולמי של המשתמש, האפליקציה צריכה לבקש את ה-Intent 'actions.intent.TEXT'.

string

רשימת ביטויים שהפעולה רוצה ש-Google תשתמש בהם לצורך הטיית דיבור. מותר להשתמש ב-1,000 ביטויים לכל היותר.

{
  "initialPrompts": [
    {
      object (SpeechResponse)
    }
  ],
  "richInitialPrompt": {
    object (RichResponse)
  },
  "noInputPrompts": [
    {
      object (SimpleResponse)
    }
  ]
}

object (SpeechResponse)

הנחיות ראשוניות שמבקשות מהמשתמש להזין קלט. יש תמיכה רק ב-first_prompt אחד.

object (RichResponse)

מטען ייעודי (payload) של הצעה לפעולה.

object (SimpleResponse)

בקשה שנשלחת למשתמש כאשר אין קלט מהמשתמש.

{

  // Union field type can be only one of the following:
  "textToSpeech": string,
  "ssml": string
  // End of list of possible types for union field type.
}

string

טקסט פשוט של פלט הדיבור, למשל: "לאן אתה רוצה ללכת?"/

string

תגובה קולית מובנית למשתמש בפורמט SSML, למשל " צריך לומר את שם בעל החיים אחרי הצליל. ". בלעדי באופן הדדי עם textToSpeech.

{
  "items": [
    {
      object (Item)
    }
  ],
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "linkOutSuggestion": {
    object (LinkOutSuggestion)
  }
}

object (Item)

רשימה של רכיבי ממשק המשתמש שמרכיבים את התגובה. הפריטים צריכים לעמוד בדרישות הבאות: 1. הפריט הראשון חייב להיות SimpleResponse 2. לכל היותר שני SimpleResponse 3. לכל היותר פריט אחד של תגובה עשירה (למשל BasicCard, StructuredResponse, MediaResponse או HtmlResponse) 4. אי אפשר להשתמש בפריט של תגובה מתקדמת אם משתמשים ב- actions.intent.OPTIONIntent כלומר ListSelect או CarouselSelect

object (Suggestion)

רשימה של הצעות לתשובות. ההצעות האלה יופיעו תמיד בסוף התשובה. אם נעשה בהם שימוש בתוך FinalResponse, המערכת תתעלם מהם.

object (LinkOutSuggestion)

צ'יפ הצעה נוסף שיכול לקשר לאפליקציה או לאתר המשויכים.

{
  "name": string,

  // Union field item can be only one of the following:
  "simpleResponse": {
    object (SimpleResponse)
  },
  "basicCard": {
    object (BasicCard)
  },
  "structuredResponse": {
    object (StructuredResponse)
  },
  "mediaResponse": {
    object (MediaResponse)
  },
  "carouselBrowse": {
    object (CarouselBrowse)
  },
  "tableCard": {
    object (TableCard)
  },
  "htmlResponse": {
    object (HtmlResponse)
  }
  // End of list of possible types for union field item.
}

string

מזהה אופציונלי בעל שם של הפריט הזה.

object (SimpleResponse)

תשובה באמצעות הודעות קוליות וטקסט בלבד.

object (BasicCard)

כרטיס בסיסי.

object (StructuredResponse)

מטען ייעודי (payload) מובנה שעובר עיבוד על ידי Google.

object (MediaResponse)

תגובה שמציינת קבוצת מדיה להפעלה.

object (CarouselBrowse)

כרטיס דפדוף בקרוסלה. במקום זאת, צריך להשתמש ב-CollectionBrowse.

object (TableCard)

כרטיס טבלה.

object (HtmlResponse)

תגובת HTML משמשת לעיבוד בלוח הציור.

{
  "textToSpeech": string,
  "ssml": string,
  "displayText": string
}

string

טקסט פשוט של פלט הדיבור, למשל: "לאן אתה רוצה ללכת?" בלעדי באופן הדדי עם ssml.

string

תגובה קולית מובנית למשתמש בפורמט SSML, למשל <speak> Say animal name after the sound. <audio src = 'https://www.pullstring.com/moo.mps' />, what’s the animal? </speak> בלעדי באופן הדדי עם textToSpeech.

string

טקסט אופציונלי להצגה בבועת הצ'אט. אם לא ניתן, ייעשה שימוש ברינדור תצוגה של ה-textToSpeech או ה-ssml שלמעלה. מוגבל ל-640 תווים.

{
  "title": string,
  "subtitle": string,
  "formattedText": string,
  "image": {
    object (Image)
  },
  "buttons": [
    {
      object (Button)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}

string

הכותרת הכוללת של הכרטיס. זה שינוי אופציונלי.

string

זה שינוי אופציונלי.

string

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

object (Image)

תמונה ראשית (Hero) של הכרטיס. הגובה קבוע ל-192dp. זה שינוי אופציונלי.

object (Button)

לחצנים. כרגע יש תמיכה בלחצן אחד לכל היותר. זה שינוי אופציונלי.

enum (ImageDisplayOptions)

סוג האפשרות להצגת תמונה. זה שינוי אופציונלי.

{
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}

string

כותרת הלחצן. חובה.

object (OpenUrlAction)

פעולה שיש לבצע כשמשתמש מקיש על הלחצן. חובה.

{

  // Union field data can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "orderUpdateV3": {
    object (OrderUpdate)
  }
  // End of list of possible types for union field data.
}

object (OrderUpdate)

האפליקציה מספקת עדכון הזמנה (למשל, Receipt) לאחר קבלת ההזמנה.

object (OrderUpdate)

האפליקציה מספקת עדכון הזמנה בפורמט API v3 אחרי קבלת ההזמנה.

{
  "googleOrderId": string,
  "actionOrderId": string,
  "orderState": {
    object (OrderState)
  },
  "orderManagementActions": [
    {
      object (Action)
    }
  ],
  "receipt": {
    object (Receipt)
  },
  "updateTime": string,
  "totalPrice": {
    object (Price)
  },
  "lineItemUpdates": {
    string: {
      object(LineItemUpdate)
    },
    ...
  },
  "userNotification": {
    object (UserNotification)
  },
  "infoExtension": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field info can be only one of the following:
  "rejectionInfo": {
    object (RejectionInfo)
  },
  "cancellationInfo": {
    object (CancellationInfo)
  },
  "inTransitInfo": {
    object (InTransitInfo)
  },
  "fulfillmentInfo": {
    object (FulfillmentInfo)
  },
  "returnInfo": {
    object (ReturnInfo)
  }
  // End of list of possible types for union field info.
}

string

מזהה ההזמנה הוא המזהה שהונפק על ידי Google.

string

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

object (OrderState)

המצב החדש של הצו.

object (Action)

עודכנו פעולות הניהול הרלוונטיות להזמנה, למשל: לנהל, לשנות או ליצור קשר עם התמיכה.

object (Receipt)

קבלה על ההזמנה.

string (Timestamp format)

מתי ההזמנה עודכנה מנקודת המבט של האפליקציה.

חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: "2014-10-02T15:01:23.045123456Z"

object (Price)

המחיר הכולל החדש של ההזמנה

map (key: string, value: object (LineItemUpdate))

מפה של השינויים ברמת הפריט, עם קידוד לפי מזהה הפריט. זה שינוי אופציונלי.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

object (UserNotification)

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

object

נתונים נוספים על סמך מצב הזמנה מותאמת אישית או בנוסף למידע על מצב רגיל.

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI המזהה את הסוג. לדוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }.

object (RejectionInfo)

מידע על מצב הדחייה.

object (CancellationInfo)

מידע על מצב הביטול.

object (InTransitInfo)

מידע על מצב התחבורה הציבורית.

object (FulfillmentInfo)

מידע על מצב האספקה.

object (ReturnInfo)

מידע על מצב ההחזרה.

{
  "type": enum (ActionType),
  "button": {
    object (Button)
  }
}

enum (ActionType)

סוג הפעולה.

object (Button)

תווית הלחצן וקישור.

{
  "confirmedActionOrderId": string,
  "userVisibleOrderId": string
}

string

מזהה ההזמנה אושר כשההזמנה התקבלה על ידי מבצע השילוב. זהו מזהה ההזמנה הקנוני המשמש במערכת השילוב מתייחס להזמנה, ולאחר מכן ניתן להשתמש בו כדי לזהות את ההזמנה כ-actionOrderId.

חשוב לשים לב שהשדה הזה הוצא משימוש. במקום זאת, יש להעביר את השדה דרך OrderUpdate.action_order_id.

string

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

{
  "type": enum (ReasonType),
  "reason": string
}

enum (ReasonType)

סוג הדחייה.

string

סיבת השגיאה.

{
  "reason": string
}

string

סיבת הביטול.

{
  "updatedTime": string
}

string (Timestamp format)

שעת העדכון האחרון של הנסיעה.

חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: "2014-10-02T15:01:23.045123456Z"

{
  "deliveryTime": string
}

string (Timestamp format)

מתי ההזמנה תושלם.

חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: "2014-10-02T15:01:23.045123456Z"

{
  "reason": string
}

string

סיבה להחזרה.

{
  "title": string,
  "text": string
}

string

הכותרת של ההודעה למשתמש.

string

תוכן ההתראה.

{
  "mediaType": enum (MediaType),
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}

enum (MediaType)

סוג המדיה בתשובה הזו.

object (MediaObject)

רשימה של אובייקטים של מדיה.

{
  "name": string,
  "description": string,
  "contentUrl": string,

  // Union field image can be only one of the following:
  "largeImage": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}

string

השם של אובייקט המדיה הזה.

string

בתיאור של אובייקט המדיה הזה.

string

כתובת ה-URL שמפנה לתוכן המדיה.

object (Image)

תמונה גדולה, כמו עטיפת האלבום וכו'.

object (Image)

סמל של תמונה קטנה שמוצג משמאל לכותרת. הגודל שלו מוקטן ל-36x36dp.

{
  "items": [
    {
      object (Item)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}

object (Item)

מינימום: 2. מקסימום: 10.

enum (ImageDisplayOptions)

סוג האפשרות להצגת תמונה. זה שינוי אופציונלי.

{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  }
}

string

הכותרת של פריט הקרוסלה. חובה.

string

בתיאור של פריט הקרוסלה. זה שינוי אופציונלי.

string

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

object (Image)

התמונה הראשית של פריט הקרוסלה. זה שינוי אופציונלי.

object (OpenUrlAction)

כתובת ה-URL של המסמך המשויך לפריט הקרוסלה. המסמך יכול להכיל תוכן HTML או, אם urlTypeHint. מוגדרת כ-AMP_CONTENT, תוכן AMP. חובה.

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columnProperties": [
    {
      object (ColumnProperties)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "buttons": [
    {
      object (Button)
    }
  ]
}

string

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

string

כותרת משנה של הטבלה. זה שינוי אופציונלי.

object (Image)

התמונה שמשויכת לטבלה. זה שינוי אופציונלי.

object (ColumnProperties)

כותרות ויישור עמודות.

object (Row)

נתוני השורה בטבלה. מובטח ש-3 השורות הראשונות יוצגו, אבל יכול להיות ששורות אחרות ייחתכו בפלטפורמות מסוימות. אפשר לנסות באמצעות הסימולטור כדי לראות אילו שורות יוצגו בפלטפורמה מסוימת. בפלטפורמות שתומכות ביכולת WEB_BROWSER, ניתן להפנות את המשתמש לדף אינטרנט שמכיל יותר נתונים.

object (Button)

לחצנים. כרגע יש תמיכה בלחצן אחד לכל היותר. זה שינוי אופציונלי.

{
  "header": string,
  "horizontalAlignment": enum (HorizontalAlignment)
}

string

טקסט הכותרת של העמודה.

enum (HorizontalAlignment)

יישור אופקי של תוכן עם עמודת w.r.t. אם לא צוין, התוכן יותאם לקצה העליון.

{
  "cells": [
    {
      object (Cell)
    }
  ],
  "dividerAfter": boolean
}

object (Cell)

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

boolean

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

{
  "text": string
}

string

תוכן הטקסט של התא.

{
  "updatedState": value,
  "suppressMic": boolean,
  "url": string
}

value (Value format)

מעבירים לאפליקציה את אובייקט ה-JSON הבא.

boolean

צריך לספק אפשרות כדי שהמיקרופון לא ייפתח אחרי התשובה הסוחפת הזו.

string

כתובת ה-URL של האפליקציה.

{
  "title": string
}

string

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

{
  "destinationName": string,
  "url": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}

string

שם האפליקציה או האתר שהצ'יפ הזה מקשר אליהם. הצ'יפ יוצג בשם 'פתוח' . עד 20 תווים. חובה.

string

הוצא משימוש. במקומו צריך להשתמש ב-OpenUrlAction.

object (OpenUrlAction)

כתובת ה-URL של האפליקציה או האתר שייפתחו כשהמשתמש יקיש על צ'יפ ההצעה. חובה לאמת את הבעלות על האפליקציה או כתובת ה-URL הזו בפעולות ב-Google Developer Console, אחרת ההצעה לא תוצג למשתמש. התכונה 'פעולה של כתובת URL פתוחה' תומכת בכתובות URL מסוג http, https ו-Intent. לכתובות URL של Intent יש לעיין בכתובת: https://developer.chrome.com/multidevice/android/intents

{
  "intent": string,
  "inputValueData": {
    "@type": string,
    field1: ...,
    ...
  },
  "parameterName": string
}

string

השם של ה-Intent המובנה, למשל actions.intent.TEXT, או כוונות שהוגדרו בחבילת הפעולות. אם הכוונה שצוינה היא לא כוונה מובנית, היא משמשת רק להטיית דיבור, והקלט שסופק על ידי Google Assistant יהיה Intent מסוג actions.intent.TEXT.

object

נתוני הגדרה נוספים שנדרשים ל-Intent מובנה. ערכים אפשריים לאובייקטים המובנים של Intent: actions.intent.OPTION -> google.actions.v2.OptionValueSpec, actions.intent.CONFIRMATION -> google.actions.v2.ConfirmationValueSpec, actions.intent.TRANSACTION_REQUIREMENTS_CHECK -> google.actions.v2.TransactionRequirementsCheckSpec, actions.intent.DELIVERY_ADDRESS -> google.actions.v2.DeliveryAddressValueSpec, actions.intent.TRANSACTION_DECISION -> google.actions.v2.TransactionDecisionValueSpec, actions.intent.PLACE -> google.actions.v2.PlaceValueSpec, actions.intent.Link -> google.actions.v2.LinkValueSpec

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI המזהה את הסוג. לדוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }.

string

אופציונלי, פרמטר של ה-Intent המבוקש. תקף רק לאובייקטים מבוקשים. משמש להטיית דיבור.

{

  // Union field response can be only one of the following:
  "speechResponse": {
    object (SpeechResponse)
  },
  "richResponse": {
    object (RichResponse)
  }
  // End of list of possible types for union field response.
}

object (SpeechResponse)

תגובה מדוברת כשהמשתמש לא נדרש להזין קלט.

object (RichResponse)

תגובת עשירה כשהמשתמש לא נדרש להזין קלט.

{
  "target": {
    object (Target)
  },

  // Union field content can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "userNotification": {
    object (UserNotification)
  }
  // End of list of possible types for union field content.
}

object (Target)

היעד שצוין לבקשת הדחיפה.

object (OrderUpdate)

עדכון הזמנה שמעדכן הזמנות שבוצעו באמצעות ממשקי API של טרנזקציות.

object (UserNotification)

אם צוין, הצגת התראה למשתמש עם כותרת וטקסט שצוינו.

{
  "title": string,
  "text": string
}

string

כותרת ההתראה.

string

תוכן ההתראה.

{
  "userId": string,
  "intent": string,
  "argument": {
    object (Argument)
  },
  "locale": string
}

string

המשתמש שצריך לטרגט.

string

הכוונה לטרגט.

object (Argument)

הארגומנט שצריך לטרגט ל-Intent. ב-V1 יש תמיכה רק בארגומנט אחד.

string

הלוקאל שאליו צריך לטרגט. לפי קוד השפה IETF BCP-47. אפשר להשתמש באפליקציה בכמה שפות כדי לטרגט משתמש באפליקציה ספציפית שמותאמת לשוק המקומי. אם לא תציינו את הערך הזה, ברירת המחדל תהיה en-US.