Method: fulfill

{
  "name": string
}

string

זה שינוי אופציונלי. שם ה-handler.

{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}

string

חובה. השם של ה-Intent האחרון שנמצאה בו התאמה.

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

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

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

string

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

{
  "original": string,
  "resolved": value
}

string

חובה. ערך הטקסט המקורי חולץ מביטוי המשתמש.

value (Value format)

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

{
  "name": string,
  "slotFillingStatus": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}

string

חובה. השם של הסצנה הנוכחית.

enum (SlotFillingStatus)

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

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

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

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

object (NextScene)

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

{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}

enum (SlotMode)

המצב של יחידת הקיבולת (חובה או אופציונלי). אפשר להגדיר זאת על ידי המפתח.

enum (SlotStatus)

הסטטוס של המשבצת.

value (Value format)

הערך של המשבצת. שינוי של הערך הזה בתשובה ישנה את הערך במילוי המשבצות.

boolean

שדה זה מציין אם הערך של יחידת הקיבולת (Slot) נאסף בפנייה האחרונה. השדה הזה הוא לקריאה בלבד.

object (Prompt)

זה שינוי אופציונלי. ההנחיה הזאת נשלחת למשתמש כשצריך למלא את המשבצת הנדרשת. ההנחיה הזאת מבטלת את ההנחיה הקיימת שמוגדרת במסוף. השדה הזה לא נכלל בבקשת ה-webhook.

{
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  },
  "orderUpdate": {
    object (OrderUpdate)
  }
}

boolean

זה שינוי אופציונלי. מצב לאופן שבו יש למזג את ההודעות האלה עם הודעות שהוגדרו קודם לכן. "true" ניקוי כל ההודעות שהוגדרו קודם לכן (הראשונה והאחרונה, תוכן, קישור להצעות וקנבס) והוספה של הודעות שהוגדרו בהנחיה הזו. "false" הוספה של הודעות שהוגדרו בהנחיה הזו להודעות שהוגדרו בתשובות הקודמות. השארת השדה הזה בסטטוס 'לא נכון' מאפשרת גם להוסיף לשדות מסוימים הנחיות פשוטות, את ההנחיה 'הצעות' ואת ההנחיה של לוח הציור (חלק משורת התוכן). הודעות התוכן והקישור תמיד מוחלפות אם הן מוגדרות בהנחיה. ערך ברירת המחדל הוא 'false'.

object (Simple)

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

object (Content)

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

object (Simple)

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

object (Suggestion)

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

object (Link)

זה שינוי אופציונלי. צ'יפ הצעה נוסף שיכול לקשר לאפליקציה או לאתר המשויכים. הצ'יפ יוצג בשם 'פתוח (שם)'. עד 20 תווים.

object (Canvas)

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

object (OrderUpdate)

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

{
  "speech": string,
  "text": string
}

string

זה שינוי אופציונלי. מייצג את הדיבור שיש לומר למשתמש. הקובץ יכול להיות בפורמט SSML או המרת טקסט לדיבור (TTS). אם האפשרות 'ביטול השינוי' בשדה שמכיל את ההנחיה הוא 'true', הדיבור שהוגדר בשדה יחליף את הדיבור בהנחיה הפשוטה הקודמת. פרטים נוספים זמינים בכתובת https://developers.google.com/assistant/conversational/ssml.

string

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

{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  },
  "collectionBrowse": {
    object (CollectionBrowse)
  }
  // End of list of possible types for union field content.
}

object (Card)

כרטיס בסיסי.

object (Image)

תמונה.

object (Table)

כרטיס טבלה.

object (Media)

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

object (Collection)

כרטיס שמציג אוסף של אפשרויות לבחירה.

object (List)

כרטיס שבו מוצגת רשימה של אפשרויות לבחירה.

object (CollectionBrowse)

כרטיס שמציג אוסף של דפי אינטרנט לפתיחה.

{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}

string

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

string

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

string

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

object (Image)

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

enum (ImageFill)

איך הרקע של התמונה יתמלא. זה שינוי אופציונלי.

object (Link)

לחצן עם קישור לאתר אחר. זה שינוי אופציונלי.

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

כתובת ה-URL של המקור של התמונה. התמונות יכולות להיות JPG, PNG ו-GIF (מונפשות ולא מונפשות). לדוגמה,https://www.agentx.com/logo.png חובה.

string

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

integer

גובה התמונה בפיקסלים. זה שינוי אופציונלי.

integer

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

{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}

string

שם הקישור. עד 20 תווים.

object (OpenUrl)

מה קורה כשמשתמש פותח את הקישור

{
  "url": string,
  "hint": enum (UrlHint)
}

string

שדה כתובת האתר שיכול להיות כל אחת מהאפשרויות: - כתובות URL מסוג http או https לפתיחת אפליקציה או דף אינטרנט שמקושרים לאפליקציה

enum (UrlHint)

מציין רמז לסוג כתובת ה-URL.

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}

string

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

string

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

object (Image)

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

object (TableColumn)

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

object (TableRow)

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

object (Link)

לחצן.

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

string

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

enum (HorizontalAlignment)

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

{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}

object (TableCell)

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

boolean

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

{
  "text": string
}

string

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

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode),
  "firstMediaObjectIndex": integer
}

enum (MediaType)

string (Duration format)

היסט ההתחלה של אובייקט המדיה הראשון.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

enum (OptionalMediaControls)

סוגים אופציונליים של פקדי מדיה שבהם הסשן הזה יכול לתמוך. אם המדיניות מוגדרת, הבקשה תישלח לצד שלישי כשיתרחש אירוע מדיה מסוים. אם לא מוגדרת, ה-3p עדיין צריך לטפל בשני סוגי בקרה שמוגדרים כברירת מחדל: FINISHED ו-FAILED.

object (MediaObject)

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

enum (RepeatMode)

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

integer

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

{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}

string

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

string

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

string

כתובת ה-URL שמפנה לתוכן המדיה. קובצי MP3 צריכים להתארח בשרת אינטרנט ולהיות זמינים לציבור דרך כתובת URL מסוג HTTPS. סטרימינג בשידור חי נתמך רק בפורמט MP3.

object (MediaImage)

תמונה להצגה עם כרטיס המדיה.

{

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

object (Image)

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

object (Image)

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

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

string

שם האוסף. זה שינוי אופציונלי.

string

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

object (CollectionItem)

רשימת פריטים. אפשר להזין עד 2 עד 10.

enum (ImageFill)

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

{
  "key": string
}

string

חובה. מפתח ה-NLU שתואם לשם של מפתח הכניסה בסוג המשויך.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}

string

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

string

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

object (ListItem)

רשימת פריטים. אפשר להזין עד 2 עד 30.

{
  "key": string
}

string

חובה. מפתח ה-NLU שתואם לשם של מפתח הכניסה בסוג המשויך.

{
  "items": [
    {
      object (Item)
    }
  ],
  "imageFill": enum (ImageFill)
}

object (Item)

רשימת פריטים. אפשר להזין עד 2 עד 10.

enum (ImageFill)

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

{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}

string

חובה. השם של פריט האוסף.

string

תיאור של פריט האוסף.

string

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

object (Image)

תמונה של הפריט באוסף.

object (OpenUrl)

חובה. URI לפתיחה אם הפריט נבחר.

{
  "title": string
}

string

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

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "continuousMatchConfig": {
    object (ContinuousMatchConfig)
  }
}

string

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

value (Value format)

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

boolean

זה שינוי אופציונלי. ערך ברירת המחדל: false.

object (ContinuousMatchConfig)

ההגדרות האישיות שמשמשות להפעלת מצב התאמה רציפה (CD)

{
  "expectedPhrases": [
    {
      object (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}

object (ExpectedPhrase)

כל הביטויים הצפויים האפשריים במהלך הסשן הזה של מצב ההתאמה המתמשכת.

integer

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

{
  "phrase": string,
  "alternativePhrases": [
    string
  ]
}

string

הביטוי שצריך להתאים במהלך סשן במצב התאמה רציפה.

string

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

{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}

enum (Type)

הוצא משימוש: במקומו, אפשר להשתמש ב-OrderUpdate.update_mask. אם type = SNAPSHOT, הפונקציה OrderUpdate.order צריכה להיות כל ההזמנה. אם הסוג = ORDER_STATUS, זהו השינוי בסטטוס ההזמנה. בוחרים רק את הפרמטר order.last_update_time והסטטוס האנכי הזה. הערה: type.ORDER_STATUS תומך רק בעדכוני סטטוס של PucahaseOrderExtension ואין תוכנית להרחיב את התמיכה הזו. במקום זאת, מומלץ להשתמש ב-updateMask כי היא שיטה כללית יותר, ניתנת להרחבה ואפשר להשתמש בה בכל הענפים.

object (Order)

string (FieldMask format)

הערה: יש שיקולים/המלצות נוספים בשדות המיוחדים הבאים: 1. order.last_update_time יעודכן תמיד כחלק מבקשת העדכון. המערכת תתעלם מ-order.create_time, order.google_order_id ו-order.merchant_order_id אם יסופק כחלק מה-updateMask.

זוהי רשימה מופרדת בפסיקים של שמות שדות מלאים. דוגמה: "user.displayName,photo"

object (UserNotification)

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

string

הסיבה לשינוי או לעדכון.

{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}

string

מזהה ההזמנה ש-Google הקצתה.

string

חובה: מזהה הזמנה פנימי הוקצה למוכר. המזהה הזה חייב להיות ייחודי והוא נדרש לפעולות הבאות של עדכון הזמנה. המזהה הזה יכול להיות מוגדר ל-googleOrderId שצוין, או לכל ערך ייחודי אחר. לתשומת ליבכם: המזהה שמוצג למשתמשים הוא userVisibleOrderId, שיכול להיות ערך אחר וידידותי יותר למשתמש. האורך המקסימלי הוא 128 תווים.

string

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

string

הוצא משימוש: יש להשתמש בסטטוס Orderתוספים במקום זאת. תווית גלויה למשתמש של מצב ההזמנה הזו.

object (UserInfo)

מידע על הקונה.

object (Image)

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

string (Timestamp format)

חובה: התאריך והשעה שבהם ההזמנה נוצרה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

התאריך והשעה שבהם ההזמנה עודכנה לאחרונה. נדרש עבור OrderUpdate.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

object (Merchant)

המוכר שאימץ את תהליך התשלום. זה יכול להיות שונה מספק ברמת הפריט. דוגמה: הזמנת Expedia עם פריט מ-ANA.

object (Contents)

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

object (PriceAttribute)

מחיר, הנחות, מיסים וכו'.

object (Action)

פעולות המשך ברמת ההזמנה.

object (PaymentData)

נתונים שקשורים לתשלום בהזמנה.

string

קישור לתנאים ולהגבלות שחלים על ההזמנה/ההצעה.

string

פתקים שמצורפים להזמנה.

object (Promotion)

כל המבצעים שמשויכים להזמנה הזו.

object (Disclosure)

גילוי נאות שמשויך להזמנה הזו.

object

הוצא משימוש: במקום זאת, יש להשתמש בפורמט אנכי. המאפיינים האלה יחולו על כל הפריטים, אלא אם הם יבוטלו בפריט מסוים. הקטגוריה הזו צריכה להתאים לסוג האנכי ברמת הפריט. ערכים אפשריים: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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

object (PurchaseOrderExtension)

הזמנת רכש

object (TicketOrderExtension)

הזמנת כרטיס

{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}

string

כתובת האימייל של המשתמש, לדוגמה: janedoe@gmail.com.

string

השם הפרטי של המשתמש.

string

שם המשפחה של המשתמש.

string

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

object (PhoneNumber)

מספרי הטלפון של המשתמש.

{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}

string

מספר טלפון בפורמט E.164, כפי שמוגדר בהמלצה E.164 של איגוד הטלקומוניקציה הבינלאומי (ITU). קישור ל-wiki: https://en.wikipedia.org/wiki/E.164

string

התוסף לא סטנדרטי בהמלצות ITU, למעט שהן מוגדרות כסדרת מספרים עם אורך מקסימלי של 40 ספרות. היא מוגדרת כמחרוזת כאן כדי לאפשר שימוש אפשרי באפס בתחילת התוסף (לארגונים יש חופש מלא לעשות זאת, מכיוון שלא הוגדר תקן). מלבד ספרות, תווי חיוג אחרים כגון "," (מצביע על המתנה) ייתכן שיאוחסן כאן. לדוגמה, ב-xxx-xxx-xxxx. 123, "123" הוא התוסף.

string

קוד בחירת הספק המועדף כשמתקשרים למספר טלפון מקומי. בכך נכללים גם קודים שצריך לחייג במדינות מסוימות כאשר מתקשרים מטלפונים נייחים לניידים, או להפך. לדוגמה, בקולומביה, המספר "3" צריך לחייג לפני מספר הטלפון עצמו כשמתקשרים מטלפון נייד לטלפון קווי מקומי ולהפך. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

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

{
  "url": string,
  "accessibilityText": string,
  "height": integer,
  "width": integer
}

string

כתובת ה-URL של המקור של התמונה. התמונות יכולות להיות JPG, PNG ו-GIF (מונפשות ולא מונפשות). לדוגמה,https://www.agentx.com/logo.png חובה.

string

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

integer

גובה התמונה בפיקסלים. זה שינוי אופציונלי.

integer

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

{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}

string

מזהה אופציונלי שהוקצה למוכר, אם יש כזה.

string

שם המוכר, למשל "Panera Bread".

object (Image)

התמונה שמשויכת למוֹכר.

object (PhoneNumber)

מספרי טלפון של מוכרים.

object (Location)

הכתובת של המוכר.

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}

object (LatLng)

קואורדינטות גיאוגרפיות. נדרש [DEVICE_PRECISE_LOCATION] ההרשאה [google.actions.v2.permission.DEVICE_PRECISE_LOCATION].

string

כתובת לתצוגה, למשל " 1600 Amphitheatre Pkwy, Mountain View, CA 94043". נדרש [DEVICE_PRECISE_LOCATION] ההרשאה [google.actions.v2.permission.DEVICE_PRECISE_LOCATION].

string

מיקוד. נדרש [DEVICE_PRECISE_LOCATION] [google.actions.v2.permission.DEVICE_PRECISE_LOCATION] או [DEVICE_COARSE_LOCATION] ההרשאה [google.actions.v2.permission.DEVICE_COARSE_LOCATION].

string

עיר. נדרש [DEVICE_PRECISE_LOCATION] [google.actions.v2.permission.DEVICE_PRECISE_LOCATION] או [DEVICE_COARSE_LOCATION] ההרשאה [google.actions.v2.permission.DEVICE_COARSE_LOCATION].

object (PostalAddress)

כתובת לדברי דואר. נדרש [DEVICE_PRECISE_LOCATION] [google.actions.v2.permission.DEVICE_PRECISE_LOCATION] או [DEVICE_COARSE_LOCATION] ההרשאה [google.actions.v2.permission.DEVICE_COARSE_LOCATION].

string

שם המקום.

string

מספר הטלפון של המיקום, למשל מספר הטלפון ליצירת קשר עם מיקום העסק או מספר הטלפון לצורך יעד המשלוח.

string

הערות לגבי המיקום.

string

השדה PlaceId משמש ב-Places API כדי לאחזר פרטים של מקום. מידע נוסף זמין בכתובת https://developers.google.com/places/web-service/place-id

{
  "latitude": number,
  "longitude": number
}

number

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].

number

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

הגרסה הקודמת של הסכימה של PostalAddress. יש להגדיר את הערך כ-0, שהוא הגרסה האחרונה.

כל הגרסאות החדשות חייבות להיות תואמות לאחור לגרסאות קודמות.

string

חובה. קוד האזור במאגר CLDR של המדינה או האזור של הכתובת. אף פעם לא מסיקים את זה, ובאחריות המשתמש לוודא שהערך נכון. פרטים נוספים זמינים בכתובת http://cldr.unicode.org/ ובכתובת http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. דוגמה: 'CH' עבור שווייץ.

string

זה שינוי אופציונלי. קוד שפה BCP-47 של תוכן הכתובת הזו (אם ידוע). לרוב זוהי שפת ממשק המשתמש של טופס הקלט, או שהיא אמורה להתאים לאחת מהשפות שציינת בכתובת מדינה/אזור, או את המקבילים בתעתיק שלהם. הפעולה הזו יכולה להשפיע על הפורמט במדינות מסוימות, אבל היא לא קריטית לנכונות של הנתונים ולא תשפיע אף פעם על אימות או על פעולות אחרות שלא קשורות לעיצוב.

אם הערך לא ידוע, יש להשמיט אותו (במקום לציין ברירת מחדל שעשויה להיות שגויה).

דוגמאות: 'zh-Hant', 'ja', 'ja-Latn', 'en'.

string

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

string

זה שינוי אופציונלי. קוד מיון נוסף ספציפי למדינה. ברוב האזורים לא נעשה שימוש בהרשאה הזו. במקומות שבהם משתמשים בו, הערך הוא מחרוזת כמו CEDEX, ואחריו מספר (למשל CEDEX 7) או מספר בלבד, שמייצג את 'קוד המגזר'. (ג'מייקה), "אינדיקטור אזור למשלוחים" (מלאווי) או "אינדיקטור של סניף דואר" (למשל, חוף השנהב).

string

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

string

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

string

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

string

שורות כתובת לא מובנות, שמתארות את הרמות הנמוכות יותר של כתובת.

מכיוון שערכים ב-addressLines לא כוללים פרטי סוג ולפעמים הם עשויים להכיל ערכים מרובים בשדה יחיד (למשל "Austin, TX"), חשוב שסדר השורות יהיה ברור. סדר שורות הכתובת צריך להיות "סדר מעטפה" עבור המדינה/האזור של הכתובת. במקומות שבהם הערך הזה יכול להשתנות (למשל, יפן), משתמשים ב-address_language כדי לציין אותה באופן מפורש (למשל 'ja' לסידור מהגדול לקטן ו-'ja-Latn' או 'en' לקטן לגדול). כך ניתן לבחור את שורת הכתובת הספציפית ביותר בהתאם לשפה.

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

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

string

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

string

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

{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}

object (LineItem)

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

{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}

string

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

string

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

string

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

object (Merchant)

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

object (PriceAttribute)

מחיר והתאמות ברמת הפריט.

object (Action)

פעולות המשך בפריט.

object (UserInfo)

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

object (Image)

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

string

תיאור הפריט.

string

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

object (Disclosure)

גילוי נאות שמשויך לפריט הזה.

object

הוצא משימוש: במקום זאת, יש להשתמש בפורמט אנכי. חובה: התוכן הסמנטי של הפריט על סמך הסוג או הענף שלו. כל קטגוריה צריכה לכלול פרטי מילוי הזמנות משלה. חייב להיות אחד מהערכים הבאים: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

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

object (PurchaseItemExtension)

הזמנות רכש כמו מוצרים, אוכל וכו'

object (ReservationItemExtension)

הזמנות מקום, כמו מסעדה, תספורת וכו'

{
  "type": enum (Type),
  "name": string,
  "id": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": integer
  // End of list of possible types for union field spec.
}

enum (Type)

חובה: מאפיין סוג הכסף.

string

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

string

אופציונלי: מזהה של הפריט שהמחיר הזה תואם לו.

enum (State)

חובה: מצב המחיר: הערכה לעומת הערך בפועל.

boolean

האם המחיר כולל מס.

object (Money)

סכום כספי.

integer

מפרט האחוזים, ל-1/1,000 מהאחוז. לדוגמה: 8.750% מיוצג כ-8750, באחוזים שליליים מייצגים הנחות באחוזים. אנחנו מוציאים את השדה הזה משימוש. כדאי להוסיף חזרה כאשר יש צורך בתרחיש לדוגמה מוצק.

{
  "currencyCode": string,
  "amountInMicros": string
}

string

קוד מטבע בן 3 אותיות שמוגדר בתקן ISO 4217.

string (int64 format)

כמות במיליוניות השנייה. לדוגמה, הגדרת השדה הזה צריכה להיות 1990000$ עבור $1.99.

{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}

enum (Type)

חובה: סוג הפעולה.

string

הכותרת או התווית של הפעולה, שמוצגות למשתמש. האורך המקסימלי המותר הוא 100 תווים.

object (OpenUrlAction)

הפעולה שצריך לבצע.

object (ActionMetadata)

מטא-נתונים שמשויכים לפעולה.

{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}

string

שדה כתובת האתר שיכול להיות כל אחת מהאפשרויות: - כתובות URL מסוג http או https לפתיחת אפליקציה או דף אינטרנט שמקושרים לאפליקציה

object (AndroidApp)

מידע על האפליקציה ל-Android, אם אפליקציה ל-Android צפויה למלא את כתובת ה-URL.

enum (UrlTypeHint)

מציין רמז לסוג כתובת ה-URL.

{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}

string

שם החבילה צריך לציין את שם החבילה כשמציינים את Android Fulfillment.

object (VersionFilter)

אם ציינת כמה מסננים, כל התאמת מסנן תפעיל את האפליקציה.

{
  "minVersion": integer,
  "maxVersion": integer
}

integer

קוד גרסה מינימלי או 0, כולל.

integer

קוד גרסה מקסימלי, כולל. הטווח החישוב הוא [minVersion:maxVersion]. טווח null מציין כל גרסה. דוגמאות: כדי לציין גרסה יחידה, צריך להשתמש בפורמט: [target_version:target_version]. כדי לציין גרסה כלשהי, צריך להשאיר את minVersion ו-maxVersion לא צוינו. כדי לציין את כל הגרסאות עד maxVersion, צריך להשאיר את minVersion ללא ציון. כדי לציין את כל הגרסאות מ-minVersion, צריך להשאיר את MaxVersion ללא ציון.

{
  "expireTime": string
}

string (Timestamp format)

השעה שבה יפוג תוקף הפעולה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}

string

הכותרת של הודעת הגילוי הנאות. דוגמה: 'מידע על בטיחות'.

object (DisclosureText)

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

object (DisclosurePresentationOptions)

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

{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}

string

טקסט להצגה, שמכיל ערכי placeholder כמו "{0}" וגם '{1}' לכל קישור טקסט שצריך להוסיף. דוגמה: "אזהרה: המוצר הזה עלול לחשוף אתכם לכימיקלים שידועים למדינת קליפורניה כגורמים לסרטן. מידע נוסף זמין בכתובת {0}." אין לכלול בטקסט הגילוי הנאות תוכן שיווקי או תוכן דמוי מודעה.

object (TextLink)

קישורי טקסט שצריך להחליף בתבנית. הראשון יוחלף ב-"{0}" במחרוזת התבנית, והשנייה עבור "{1}" וכו'.

{
  "displayText": string,
  "url": string
}

string

טקסט שאמור להיות מוצג למשתמשים.

string

כתובת ה-URL שאליה המשתמשים יופנו כשהקישור מופעל.

{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}

enum (PresentationRequirement)

הדרישה להציג את הגילוי הנאות.

boolean

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

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "productDetails": {
    object (ProductDetails)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

חובה: סטטוס ברמת הפריט.

string

חובה: תווית/מחרוזת הגלויים למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים.

enum (PurchaseType)

חובה: סוג הרכישה.

string

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

integer

כמות היחידות של הפריט.

object (MerchantUnitMeasure)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object (ItemOption)

תוספים או פריטי משנה נוספים.

object (ProductDetails)

פרטים על המוצר.

object

כל שדה מיותר שהוחלף בין המוכר ל-Google. הערה: מומלץ מאוד לא להשתמש בתוסף הזה. בהתאם לתרחיש או הנסיבות, מומלץ לשקול אחת מהאפשרויות הבאות: 1. יש להגדיר שדות ב-PurchaseItemExtension אם הם יכולים לשמש לתרחישי שימוש אחרים (כלומר, יכולת/פונקציונליות כללית). 2. יש להשתמש ב-Vertical_extension אם הוא ספציפי לתרחיש או לתכונה מותאמים אישית ולא כלליים.

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

{
  "measure": number,
  "unit": enum (Unit)
}

number

ערך: דוגמה 1.2.

enum (Unit)

Unit: POUND, GRAM

{
  "isReturnable": boolean,
  "daysToReturn": integer,
  "policyUrl": string
}

boolean

אם True, מותר להחזיר.

integer

מותר להחזיר מוצרים בתוך מספר הימים הזה.

string

קישור למדיניות החזרת המוצרים.

{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}

string

מזהה ייחודי של אפשרות השירות הזו.

enum (Type)

חובה: סוג מילוי ההזמנה.

object (Time)

חלון אם צוין טווח זמן או זמן הגעה משוער אם צוין שעה אחת. זמן האספקה או האיסוף הצפוי.

object (Time)

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

object (Location)

מיקום האיסוף או המשלוח.

string (Timestamp format)

השעה שבה יפוג התוקף של אפשרות מילוי ההזמנה הזו.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

object (PriceAttribute)

העלות של האפשרות הזו.

object (UserInfo)

איש הקשר של המשתמש למילוי ההזמנות.

string

שם שיטת המשלוח שנבחרה על ידי המשתמש.

string

קוד החנות של המיקום. דוגמה: Walmart הוא המוכר, ו-storeCode הוא החנות ב-Walmart שבה בוצע מילוי ההזמנה. https://support.google.com/business/answer/3370250?ref_topic=4596653.

object (PickupInfo)

מידע נוסף על אופן הבחירה של ההזמנה. השדה הזה רלוונטי רק אם סוג מילוי ההזמנה הוא PICKUP.

{
  "timeIso8601": string
}

string

מייצג את המועד של אירוע ההזמנה, כמו זמן ההזמנה, זמן האספקה וכן הלאה. הערך יכול להיות משך זמן (שעת התחלה וסיום), תאריך, תאריך ושעה וכו'. מידע נוסף זמין בכתובת https://en.wikipedia.org/wiki/ISO_8601 כדי לראות את כל הפורמטים הנתמכים.

{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}

enum (PickupType)

שיטת איסוף, כמו INSTORE, CURBSIDE וכו'.

object (CurbsideInfo)

פרטים ספציפיים למידע על מדלת העסק. אם הערך שלpickupType הוא לא CURBSIDE, המערכת תתעלם מהשדה הזה.

object (CheckInInfo)

רשימת שיטות שונות שבהן השותף תומך בצ'ק-אין.

{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}

enum (CurbsideFulfillmentType)

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

object (Vehicle)

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

{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}

string

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

string

דגם הרכב (למשל, 'Grom'). הערך הזה מוצג למשתמש וצריך להתאים אותו לשוק המקומי. חובה.

string

מספר לוחית רישוי לרכב (למשל: 1ABC234). חובה.

string

שם הצבע של הרכב, למשל שחור אופציונלי.

object (Image)

כתובת URL של תמונה של הרכב. התמונה תוצג בגודל של כ-256x256 פיקסלים. הקובץ חייב להיות JPG או PNG. זה שינוי אופציונלי.

{
  "checkInType": enum (CheckInType)
}

enum (CheckInType)

השיטה ששימשה לשליחת הוראות הצ'ק-אין.

{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}

string

לאפשרויות שהן פריטים, צריך לציין מזהה פריט ייחודי.

string

שם האפשרות.

object (PriceAttribute)

המחיר הכולל של האפשרות.

string

הערה שקשורה לאפשרות.

integer

לאפשרויות שהן פריטים, כמות.

string

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

object (ItemOption)

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

{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}

string

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

string

מספר הפריט המסחרי הגלובלי של המוצר. שימושי אם מזהה המבצע לא קיים ב-Merchant Center. זה שינוי אופציונלי.

string

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

string

קטגוריית המוצר שהוגדרה על ידי המוֹכר. לדוגמה "דף הבית > מכולת > מוצרי חלב ביצים > חלב > חלב מלא"

map (key: string, value: string)

פרטים שהמוכר סיפק לגבי המוצר, למשל: { "allergen": "peanut" }. שימושי אם מזהה המבצע לא קיים ב-Merchant Center. זה שינוי אופציונלי.

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

{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  }
}

enum (ReservationStatus)

חובה: סטטוס הזמנה.

string

חובה: תווית/מחרוזת הגלויים למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים.

enum (ReservationType)

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

object (Time)

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

object (Time)

טווח הזמן המקובל על המשתמש.

string

קוד האישור של ההזמנה הזו.

integer

מספר האנשים.

object (StaffFacilitator)

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

object (Location)

מיקום השירות או האירוע.

{
  "name": string,
  "image": {
    object (Image)
  }
}

string

השם של מנחה הצוות. דוגמה: "ישראל ישראלי"

object (Image)

התמונות של האומן/ית.

{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}

object (PaymentResult)

תוצאת תשלום שמשמשת את מבצע השילוב להשלמת עסקה. השדה הזה יאוכלס ב-Actions on Google אם חוויית התשלום מנוהלת על ידי Actions-on-Google.

object (PaymentInfo)

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

{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}

string

נתונים של אמצעי התשלום שסופקו על ידי Google. אם ספק שירותי התשלומים שלך רשום כאן בתור ספק שירותי תשלומים שנתמך על ידי Google: https://developers.google.com/pay/api/ כדי לקבל פרטים נוספים, אפשר לעבור אל ספק שירותי התשלומים דרך הקישור. אחרת, אפשר לעיין במסמכים הבאים לקבלת פרטים על המטען הייעודי (payload). https://developers.google.com/pay/api/payment-data-cryptography

string

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

{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}

object (PaymentMethodDisplayInfo)

פרטי התצוגה של אמצעי התשלום ששימש לעסקה.

enum (PaymentMethodProvenance)

המקור של אמצעי התשלום ששימש לביצוע העסקה. יכול להיות שהמשתמש רשם את אותו אמצעי תשלום גם ב-Google וגם ב-Merchant.

{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}

enum (PaymentType)

סוג התשלום.

string

השם הגלוי למשתמש של אמצעי התשלום. לדוגמה, VISA **** 1234 בדיקה חשבון **** 5678

string

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

{
  "coupon": string
}

string

נדרש: קוד השובר שהוחל על המבצע הזה.

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

חובה: הסטטוס הכולל של ההזמנה.

string

תווית/מחרוזת גלויים למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים.

enum (PurchaseType)

חובה: סוג הרכישה.

object (PurchaseReturnsInfo)

פרטי ההחזרה של ההזמנה.

object (PurchaseFulfillmentInfo)

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

enum (PurchaseLocationType)

מיקום הרכישה (בחנות או באינטרנט)

object (PurchaseError)

אופציונלי: שגיאות שבגללן ההזמנה הזו נדחתה.

object

כל שדה מיותר שהוחלף בין המוכר ל-Google. הערה: מומלץ מאוד לא להשתמש בתוסף הזה. בהתאם לתרחיש או הנסיבות, מומלץ לשקול אחת מהאפשרויות הבאות: 1. יש להגדיר שדות ב-PurchaseOrderExtension אם אפשר להשתמש בהם לתרחישים אחרים לדוגמה (כלומר, יכולות/פונקציונליות כלליות). 2. יש להשתמש ב-Vertical_extension אם הוא ספציפי לתרחיש או לתכונה מותאמים אישית ולא כלליים.

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

{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}

enum (ErrorType)

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

string

תיאור שגיאה נוסף.

string

מזהה הישות שתואם לשגיאה. דוגמה לכך יכולה להתאים ל-LineItemId / ItemOptionId.

object (PriceAttribute)

רלוונטי במקרה של סוג השגיאה PRICE_CHANGED / INCORRECT_PRICE.

integer

כמות זמינה עכשיו. רלוונטי במקרה של AVAILABILITY_CHANGED.

{
  "ticketEvent": {
    object (TicketEvent)
  }
}

object (TicketEvent)

האירוע הזה חל על כל הכרטיסים בפריטים.

{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}

enum (Type)

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

string

חובה: שם האירוע. לדוגמה, אם האירוע הוא סרט, הוא צריך להיות שם הסרט.

string

תיאור האירוע.

string

כתובת URL לפרטי האירוע.

object (Location)

המיקום שבו מתקיים האירוע או המיקום של הארגון.

object (EventCharacter)

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

object (Time)

שעת התחלה.

object (Time)

שעת סיום.

object (Time)

שעת הכניסה, שעשויה להיות שונה משעת ההתחלה של האירוע. לדוגמה האירוע מתחיל ב-9:00 אבל שעת הכניסה היא 8:30.

{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}

enum (Type)

סוג תו האירוע, למשל שחקן או במאי.

string

שם הדמות.

object (Image)

התמונות של הדמות.

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

string

הכותרת של ההודעה למשתמש. האורך המקסימלי המותר הוא 30 תווים.

string

תוכן ההתראה. האורך המקסימלי המותר הוא 100 תווים.

{
  "name": string
}

string

שם הסצנה שרוצים לבצע בשלב הבא.

{
  "id": string,
  "params": {
    string: value,
    ...
  },
  "typeOverrides": [
    {
      object (TypeOverride)
    }
  ],
  "languageCode": string
}

string

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

map (key: string, value: value (Value format))

חובה. רשימה של כל הפרמטרים שנאספו מטפסים ומ-Intent במהלך הסשן. המפתח הוא שם הפרמטר. פרמטרים שמוגדרים כאן ימוזגו עם פרמטרים שכבר הוגדרו בסשן. פרמטרים שהערך שלהם הוא null יוסרו מהסשן. לעיון בתיעוד לגבי אחסון הסשנים: https://developers.google.com/assistant/conversational/storage-session.

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

object (TypeOverride)

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

string

השפה של השיחה הנוכחית. תואם לקוד השפה IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt. זה יכול להיות שונה מהלוקאל של המשתמש אם הפעולה משתמשת בתכונות בכמה שפות. לדוגמה, כאשר מוגדר handler_response.expected.language_code הוא משנה את שפת השיחה בכל הפניות הבאות, והדבר ישתקף בשדה הזה.

{
  "name": string,
  "mode": enum (TypeOverrideMode),
  "synonym": {
    object (SynonymType)
  }
}

string

חובה. שם של הסוג שרוצים להוסיף או לשנות.

enum (TypeOverrideMode)

חובה. איך למזג את הסוג הזה עם ערכים של סוגים אחרים.

object (SynonymType)

{
  "entries": [
    {
      object (Entry)
    }
  ]
}

object (Entry)

חובה. רשימת הערכים של סוג המילה הנרדפת.

{
  "name": string,
  "synonyms": [
    string
  ],
  "display": {
    object (EntryDisplay)
  }
}