Order

ישות ההזמנה. הערה: 1. כל המחרוזות בכל הרמות חייבות להיות באורך של פחות מ-1,000 תווים, אלא אם צוין אחרת. 2. כל השדות החוזרים בכל הרמות חייבים להיות קטנים מ-50, אלא אם צוין אחרת. 3. אם מציינים את כל חותמות הזמן בכל הרמות, הן חייבות להיות חותמות זמן תקינות.

ייצוג JSON 
{
  "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.
}
שדות
googleOrderId

string

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

merchantOrderId

string

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

userVisibleOrderId

string

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

userVisibleStateLabel
(deprecated)

string

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

object (UserInfo)

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

image

object (Image)

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

createTime

string (Timestamp format)

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

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

string (Timestamp format)

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

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

object (Merchant)

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

contents

object (Contents)

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

priceAttributes[]

object (PriceAttribute)

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

followUpActions[]

object (Action)

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

paymentData

object (PaymentData)

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

termsOfServiceUrl

string

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

note

string

הערות המצורפות להזמנה.

promotions[]

object (Promotion)

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

disclosures[]

object (Disclosure)

הודעות גילוי נאות המשויכות להזמנה הזו.

vertical
(deprecated)

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" }
שדה איחוד verticals. המאפיינים האלה יחולו על כל הפריטים, אלא אם הם יבוטלו בפריט מסוים. הקטגוריה הזו חייבת להתאים לסוג האנכי ברמת הפריט. הערך של verticals יכול להיות רק אחת מהאפשרויות הבאות:
purchase

object (PurchaseOrderExtension)

הזמנת רכש

ticket

object (TicketOrderExtension)

הזמנת כרטיסים

UserInfo

מידע על המשתמש. משמש לייצוג מידע של המשתמש שמשויך להזמנה.

ייצוג JSON 
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
שדות
email

string

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

firstName

string

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

lastName

string

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

displayName

string

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

phoneNumbers[]

object (PhoneNumber)

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

PhoneNumber

ייצוג סטנדרטי של מספרי טלפון.

ייצוג JSON 
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
שדות
e164PhoneNumber

string

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

extension

string

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

preferredDomesticCarrierCode

string

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

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

תמונה

תמונה שמוצגת בכרטיס.

ייצוג JSON 
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
שדות
url

string

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

accessibilityText

string

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

height

number

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

width

number

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

מוֹכר

המוכר של עגלת הקניות/ההזמנה/הפריט.

ייצוג JSON 
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
שדות
id

string

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

name

string

שם המוכר, כמו "לחם פנרה".

image

object (Image)

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

phoneNumbers[]

object (PhoneNumber)

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

address

object (Location)

כתובת המוכר.

מיקום

מאגר שמייצג מיקום.

ייצוג JSON 
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
שדות
coordinates

object (LatLng)

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

string

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

string

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

string

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

object (PostalAddress)

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

string

שם המקום.

phoneNumber

string

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

notes

string

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

placeId

string

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

LatLng

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

ייצוג JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

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

longitude

number

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

PostalAddress

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

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

עצות לגבי קלט / עריכה של כתובת: - יש להשתמש בווידג'ט כתובת המוכן ל-i18n, כגון https://github.com/google/libaddressinput) - אין להציג למשתמשים אלמנטים של ממשק המשתמש לצורך קלט או עריכה של שדות מחוץ למדינות שבהן נעשה שימוש בשדה הזה.

לקבלת הנחיות נוספות לגבי השימוש בסכימה הזו, ניתן לעיין בכתובת: https://support.google.com/business/answer/6397478

ייצוג JSON 
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
שדות
revision

number

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

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

string

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

languageCode

string

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

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

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

string

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

sortingCode

string

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

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

string

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

organization

string

אפשרות. שם הארגון בכתובת.

תוכן עניינים

ראפ לפריטים.

ייצוג JSON 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
שדות
lineItems[]

object (LineItem)

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

LineItem

פריט אחד מכיל אנכי אחד. הזמנה או עגלה יכולים לכלול מספר פריטים באותה תעשייה. יש להגדיר פריטי משנה/תוספות וכו' בפרוטוקולים אנכיים בהתאם לתרחישי השימוש שלהם. הערה: 1. כל המחרוזות בכל הרמות חייבות להיות באורך של פחות מ-1,000 תווים, אלא אם צוין אחרת. 2. כל השדות החוזרים בכל הרמות חייבים להיות קטנים מ-50, אלא אם צוין אחרת. 3. אם מציינים את כל חותמות הזמן בכל הרמות, הן חייבות להיות חותמות זמן תקינות.

ייצוג JSON 
{
  "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.
}
שדות
id

string

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

name

string

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

userVisibleStateLabel
(deprecated)

string

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

object (Merchant)

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

priceAttributes[]

object (PriceAttribute)

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

followUpActions[]

object (Action)

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

recipients[]

object (UserInfo)

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

image

object (Image)

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

description

string

תיאור הפריט.

notes[]

string

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

disclosures[]

object (Disclosure)

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

vertical
(deprecated)

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" }
שדה איחוד verticals. חובה: התוכן הסמנטי של הפריט על סמך הסוג או הקטגוריה שלו. כל קטגוריה צריכה לכלול פרטים משלה על מילוי הזמנות. הערך של verticals יכול להיות רק אחת מהאפשרויות הבאות:
purchase

object (PurchaseItemExtension)

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

reservation

object (ReservationItemExtension)

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

PriceAttribute

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

ייצוג JSON 
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

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

enum (Type)

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

name

string

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

state

enum (State)

חובה: מצב המחיר: אומדן לעומת בפועל.

taxIncluded

boolean

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

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

object (Money)

סכום כספי.

amountMillipercentage
(deprecated)

number

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

תיאור

מייצג את סוג הכסף.

טיפוסים בני מנייה (enums)
TYPE_UNSPECIFIED הסוג לא צוין, הלקוחות לא צריכים להגדיר זאת במפורש.
REGULAR מחיר תצוגה רגיל, לפני שהוחלו הנחות וכו'.
DISCOUNT יש לחסר לסכום הביניים.
TAX להוספה לסכום הביניים.
DELIVERY להוספה לסכום הביניים.
SUBTOTAL סיכום ביניים לפני הוספה של חלק מהעמלות.
FEE כל עמלה נוספת.
GRATUITY להוספה לסכום הביניים.
TOTAL המחיר המוצג של ההזמנה או הפריט.

ארץ

מצב המחיר.

טיפוסים בני מנייה (enums)
STATE_UNSPECIFIED לא צוין.
ESTIMATE המחיר הוא אומדן בלבד.
ACTUAL המחיר בפועל שבו יחויבו המשתמש.

כסף

מייצג סכום כסף לפי סוג המטבע.

ייצוג JSON 
{
  "currencyCode": string,
  "amountInMicros": string
}
שדות
currencyCode

string

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

amountInMicros

string (int64 format)

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

פעולה

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

ייצוג JSON 
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
שדות
type

enum (Type)

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

title

string

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

openUrlAction

object (OpenUrlAction)

הפעולה לביצוע.

actionMetadata

object (ActionMetadata)

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

תיאור

פעולות מעקב אפשריות.

טיפוסים בני מנייה (enums)
TYPE_UNSPECIFIED פעולה לא מוגדרת.
VIEW_DETAILS הצגת פעולה לגבי פרטי ההזמנה.
MODIFY שינוי הפעולה בהזמנה.
CANCEL ביטול הפעולה בהזמנה.
RETURN פעולת הזמנה של החזרת מוצר.
EXCHANGE פעולת המרה של הזמנה.
EMAIL

פעולה באימייל. סוגי EMAIL ו-CALL הוצאו משימוש. openUrlAction.url יכול לשמש כמספר טלפון או כאימייל.
CALL

פעולת קריאה.
REORDER שינוי סדר הפעולה.
REVIEW בדיקה של פעולת ההזמנה.
CUSTOMER_SERVICE יצירת קשר עם שירות הלקוחות.
FIX_ISSUE צריך להפנות לאתר או לאפליקציה של המוכר כדי לפתור את הבעיה.
DIRECTION קישור למסלול.

OpenUrlAction

פתיחת כתובת ה-URL הנתונה.

ייצוג JSON 
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
שדות
url

string

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

androidApp

object (AndroidApp)

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

urlTypeHint

enum (UrlTypeHint)

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

AndroidApp

מפרט האפליקציה ל-Android לגבי הגבלות מילוי ההזמנה

ייצוג JSON 
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
שדות
packageName

string

כשמציינים את שם החבילה, יש לציין את שם החבילה.

versions[]

object (VersionFilter)

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

VersionFilter

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

ייצוג JSON 
{
  "minVersion": number,
  "maxVersion": number
}
שדות
minVersion

number

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

maxVersion

number

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

UrlTypeHint

סוגים שונים של רמזים לכתובות URL.

טיפוסים בני מנייה (enums)
URL_TYPE_HINT_UNSPECIFIED לא צוין
AMP_CONTENT כתובת URL שמפנה ישירות לתוכן AMP או לכתובת URL קנונית שמפנה לתוכן AMP דרך <link rel="amphtml">

ActionMetadata

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

ייצוג JSON 
{
  "expireTime": string
}
שדות
expireTime

string (Timestamp format)

השעה שבה הפעולה הזו תפוג.

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

גילוי נאות

גילוי נאות לגבי מוצר, שירות או מדיניות שעשוי להיות מוצג למשתמש.

ייצוג JSON 
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
שדות
title

string

שם הגילוי הנאות. דוגמה: "מידע על בטיחות".

disclosureText

object (DisclosureText)

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

presentationOptions

object (DisclosurePresentationOptions)

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

DisclosureText

מייצג טקסט פשוט עם קישורי אינטרנט.

ייצוג JSON 
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
שדות
template

string

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

DisclosurePresentationOptions

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

ייצוג JSON 
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
שדות
presentationRequirement

enum (PresentationRequirement)

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

initiallyExpanded

boolean

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

PresentationRequirement

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

טיפוסים בני מנייה (enums)
REQUIREMENT_UNSPECIFIED דרישה לא מוגדרת. אין להגדיר זאת במפורש.
REQUIREMENT_OPTIONAL הגילוי הנאות הוא אופציונלי. ניתן לדלג עליו אם המכשיר לא תומך בהצגת גילויים נאותים.
REQUIREMENT_REQUIRED הגילוי הנאות הוא חובה. השיחה תופנה לטלפון אם המכשיר לא תומך בהצגת גילויים נאותים.

PurchaseItemExtension

תוכן הפריט בקטגוריית הרכישה.

ייצוג JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
שדות
status

enum (PurchaseStatus)

נדרש: סטטוס ברמת הפריט.

userVisibleStatusLabel

string

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

type

enum (PurchaseType)

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

productId
(deprecated)

string

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

number

כמות הפריט.

unitMeasure

object (MerchantUnitMeasure)

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

returnsInfo

object (PurchaseReturnsInfo)

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

fulfillmentInfo

object (PurchaseFulfillmentInfo)

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

itemOptions[]

object (ItemOption)

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

extension

object

כל השדות הנוספים שיועברו בין המוכר ל-Google.

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

object (ProductDetails)

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

PurchaseStatus

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

טיפוסים בני מנייה (enums)
PURCHASE_STATUS_UNSPECIFIED הסטטוס לא צוין.
READY_FOR_PICKUP מוכנה לאיסוף.
SHIPPED ההודעה נשלחה.
DELIVERED ההודעה נמסרה.
OUT_OF_STOCK חסר במלאי.
IN_PREPARATION ל-"IN_PREPARATION" יכולה להיות משמעות שונה בהקשר אחר. בהזמנת אוכל, יכול להיות שמכינים אוכל. בקמעונאות, ייתכן שפריט נמצא בחבילה.
CREATED ההזמנה נוצרה.
CONFIRMED המוכר אישר את ההזמנה.
REJECTED המוכר דחה את ההזמנה או את הפריט.
RETURNED הפריט הוחזר על ידי המשתמש.
CANCELLED ההזמנה או הפריט בוטלו על ידי המשתמש.
CHANGE_REQUESTED המשתמש ביקש שינוי בהזמנה, והשותף מעבד את השינוי הזה. לאחר הטיפול בבקשה, ההזמנה תועבר למצב אחר.

PurchaseType

קטגוריית הרכישה.

טיפוסים בני מנייה (enums)
PURCHASE_TYPE_UNSPECIFIED ערך לא ידוע.
RETAIL היא כוללת רכישות כמו מוצרים פיזיים.
FOOD הנתון כולל רכישה של הזמנת אוכל.
GROCERY רכישה של מוצרי מכולת.
MOBILE_RECHARGE רכישה של טעינת כסף בנייד בתשלום מראש.

MerchantUnitMeasure

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

ייצוג JSON 
{
  "measure": number,
  "unit": enum (Unit)
}
שדות
measure

number

ערך: דוגמה 1.2.

unit

enum (Unit)

יחידה: דוגמה ל-POUND, GRAM.

יחידה

טיפוסים בני מנייה (enums)
UNIT_UNSPECIFIED היחידה לא צוינה.
MILLIGRAM מיליגרם.
GRAM גרם
KILOGRAM קילוגרם.
OUNCE אונקיה.
POUND לירה סטרלינג

PurchaseReturnsInfo

מחזירה מידע המשויך להזמנה או לפריט מסוים.

ייצוג JSON 
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
שדות
isReturnable

boolean

אם הערך הוא true, אפשר להחזיר אותו.

daysToReturn

number

ניתן להחזיר פריטים בתוך מספר הימים הזה.

policyUrl

string

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

PurchaseFulfillmentInfo

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

ייצוג JSON 
{
  "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)
  }
}
שדות
id

string

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

fulfillmentType

enum (Type)

חובה: סוג האספקה.

expectedFulfillmentTime

object (Time)

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

expectedPreparationTime

object (Time)

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

location

object (Location)

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

expireTime

string (Timestamp format)

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

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

object (PriceAttribute)

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

fulfillmentContact

object (UserInfo)

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

shippingMethodName

string

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

storeCode

string

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

pickupInfo

object (PickupInfo)

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

תיאור

סוג האספקה.

טיפוסים בני מנייה (enums)
TYPE_UNSPECIFIED הסוג לא צוין.
DELIVERY ההזמנה הזו תסופק.
PICKUP יש לאסוף את ההזמנה הזו.

שעה

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

ייצוג JSON 
{
  "timeIso8601": string
}
שדות
timeIso8601

string

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

PickupInfo

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

ייצוג JSON 
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
שדות
pickupType

enum (PickupType)

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

curbsideInfo

object (CurbsideInfo)

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

checkInInfo[]

object (CheckInInfo)

רשימת השיטות השונות שנתמכות על ידי השותף לצורך צ'ק-אין.

PickupType

רשימה של סוגי האיסוף הנתמכים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין סוג האיסוף.
INSTORE לאסוף אוכל מתוך המסעדה.
CURBSIDE יש לחנות רכב במקום ייעודי מחוץ למסעדה, ומישהו היה מספק שם משלוח.

CurbsideInfo

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

ייצוג JSON 
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
שדות
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

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

userVehicle

object (Vehicle)

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

CurbsideFulfillmentType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין סוג מילוי ההזמנה מדלת העסק.
VEHICLE_DETAIL כדי לאפשר איסוף מדלת העסק, נדרשים פרטי הרכב.

כלי רכב

פרטים על רכב

ייצוג JSON 
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
שדות
make

string

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

model

string

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

licensePlate

string

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

colorName

string

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

image

object (Image)

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

CheckInInfo

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

ייצוג JSON 
{
  "checkInType": enum (CheckInType)
}
שדות
checkInType

enum (CheckInType)

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

CheckInType

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

טיפוסים בני מנייה (enums)
CHECK_IN_TYPE_UNSPECIFIED ערך לא ידוע.
EMAIL פרטי הצ'ק אין יישלחו באימייל.
SMS פרטי הצ'ק אין יישלחו ב-SMS.

ItemOption

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

ייצוג JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
שדות
id

string

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

name

string

שם האפשרות.

prices[]

object (PriceAttribute)

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

note

string

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

quantity

number

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

productId

string

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

subOptions[]

object (ItemOption)

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

ProductDetails

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

ייצוג JSON 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
שדות
productId

string

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

gtin

string

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

plu

string

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

productType

string

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

productAttributes

map (key: string, value: string)

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

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

ReservationItemExtension

תוכן של פריטים בהזמנות בהזמנה כמו מסעדה, תספורת וכו'. המזהה הבא: 15.

ייצוג JSON 
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
שדות
status

enum (ReservationStatus)

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

userVisibleStatusLabel

string

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

type

enum (ReservationType)

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

reservationTime

object (Time)

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

userAcceptableTimeRange

object (Time)

טווח הזמנים המקובל על המשתמש.

confirmationCode

string

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

partySize

number

מספר האנשים.

staffFacilitators[]

object (StaffFacilitator)

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

location

object (Location)

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

extension

object

כל השדות הנוספים שיועברו בין המוכר ל-Google.

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

ReservationStatus

סטטוס ההזמנה.

טיפוסים בני מנייה (enums)
RESERVATION_STATUS_UNSPECIFIED הסטטוס לא צוין.
PENDING ההזמנה בהמתנה.
CONFIRMED ההזמנה אושרה.
CANCELLED המשתמש ביטל את ההזמנה.
FULFILLED ההזמנה בוצעה.
CHANGE_REQUESTED נשלחה בקשה לשינוי ההזמנה
REJECTED תוקף ההזמנה פג או נדחה על ידי מבצע השילוב.

ReservationType

סוג ההזמנה.

טיפוסים בני מנייה (enums)
RESERVATION_TYPE_UNSPECIFIED הסוג לא צוין.
RESTAURANT הזמנה למסעדה.
HAIRDRESSER הזמנה למספרה.

StaffFacilitator

מידע על איש השירות.

ייצוג JSON 
{
  "name": string,
  "image": {
    object (Image)
  }
}
שדות
name

string

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

image

object (Image)

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

PaymentData

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

ייצוג JSON 
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
שדות
paymentResult

object (PaymentResult)

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

paymentInfo

object (PaymentInfo)

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

PaymentResult

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

ייצוג JSON 
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
שדות
שדה איחוד result. סיפקת נתוני תשלום מ-Google או אמצעי תשלום של מוכר. הערך של result יכול להיות רק אחת מהאפשרויות הבאות:
googlePaymentData

string

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

merchantPaymentMethodId

string

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

PaymentInfo

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

ייצוג JSON 
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
שדות
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

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

paymentMethodProvenance

enum (PaymentMethodProvenance)

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

PaymentMethodDisplayInfo

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

ייצוג JSON 
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
שדות
paymentType

enum (PaymentType)

סוג התשלום.

paymentMethodDisplayName

string

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

paymentMethodVoiceName

string

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

PaymentType

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

טיפוסים בני מנייה (enums)
PAYMENT_TYPE_UNSPECIFIED סוג התשלום לא צוין.
PAYMENT_CARD כרטיס אשראי/כרטיס חיוב מיידי או כרטיס נטען.
BANK אמצעי התשלום הוא חשבון בנק.
LOYALTY_PROGRAM אמצעי התשלום הוא מועדון לקוחות.
CASH אמצעי התשלום הוא במזומן.
GIFT_CARD אמצעי התשלום הוא כרטיס מתנה.
WALLET ארנק של צד שלישי, למשל PayPal

PaymentMethodProvenance

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

טיפוסים בני מנייה (enums)
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED לא צוין המקור.
PAYMENT_METHOD_PROVENANCE_GOOGLE מוצא הוא Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT המקור הוא המוכר.

תוכן מקודם

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

ייצוג JSON 
{
  "coupon": string
}
שדות
coupon

string

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

PurchaseOrderExtension

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

ייצוג JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
שדות
status

enum (PurchaseStatus)

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

userVisibleStatusLabel

string

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

type

enum (PurchaseType)

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

returnsInfo

object (PurchaseReturnsInfo)

החזרת פרטי ההזמנה.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

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

extension

object

כל השדות הנוספים שיועברו בין המוכר ל-Google.

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

enum (PurchaseLocationType)

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

errors[]

object (PurchaseError)

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

PurchaseLocationType

סוג המיקום של הרכישה.

טיפוסים בני מנייה (enums)
UNSPECIFIED_LOCATION ערך לא ידוע.
ONLINE_PURCHASE כל הרכישות שנקנו באינטרנט.
INSTORE_PURCHASE כל הרכישות בחנות.

PurchaseError

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

ייצוג JSON 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
שדות
type

enum (ErrorType)

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

description

string

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

entityId

string

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

updatedPrice

object (PriceAttribute)

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

availableQuantity

number

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

ErrorType

סוגי שגיאות אפשריים.

טיפוסים בני מנייה (enums)
ERROR_TYPE_UNSPECIFIED שגיאה לא ידועה
NOT_FOUND הישות לא נמצאה, יכול להיות פריט, FulfillmentOption, קידום. נדרש מזהה ישות.
INVALID נתוני הישות לא תקינים. יכול להיות 'פריט', 'FulfillmentOption', 'קידום מכירות'. נדרש מזהה ישות.
AVAILABILITY_CHANGED הפריט אינו זמין, או שאין מספיק פריטים למילוי הבקשה. נדרש מזהה ישות.
PRICE_CHANGED מחיר הפריט שונה מהמחיר בישות 'פריט'. חובה לציין מזהה ישות ומחיר מעודכן.
INCORRECT_PRICE שגיאות במחיר ב'עמלות', 'סה"כ'. חובה לציין מזהה ישות ומחיר מעודכן.
REQUIREMENTS_NOT_MET אין עמידה במגבלות על קבלת הזמנה – גודל סל מינימלי וכו'.
TOO_LATE פג התוקף של FulfillmentOption.
NO_CAPACITY אין קיבולת שירות זמינה.
INELIGIBLE המשתמש לא כשיר לביצוע ההזמנה (ברשימה שחורה).
OUT_OF_SERVICE_AREA לא ניתן לשלוח את ההזמנה לכתובת המבוקשת בגלל כללי גבול וכו'.
CLOSED המסעדה סגורה לעסקים בזמן ההזמנה.
PROMO_NOT_APPLICABLE קוד שגיאה כללי לזיהוי כל המקרים של כשל בהחלת קוד ההטבה, אם אף אחד מהקודמים לא מתאים. הוספת קוד הטבה כמזהה ישות.
PROMO_NOT_RECOGNIZED השותף לא זיהה את קוד השובר. הוספת קוד הטבה כמזהה ישות.
PROMO_EXPIRED לא ניתן להחיל כי פג התוקף של המבצע. הוספת קוד הטבה כמזהה ישות.
PROMO_USER_INELIGIBLE המשתמש הנוכחי אינו זכאי לשובר זה. הוספת קוד הטבה כמזהה ישות.
PROMO_ORDER_INELIGIBLE ההזמנה הנוכחית אינה כשירה לשובר זה. הוספת קוד הטבה כמזהה ישות.
UNAVAILABLE_SLOT המשבצת להזמנה מראש לא זמינה.
FAILED_PRECONDITION אין עמידה במגבלות על קבלת הזמנה – גודל סל מינימלי וכו'.
PAYMENT_DECLINED תשלום לא חוקי.
MERCHANT_UNREACHABLE אי אפשר להשיג את המוֹכר. האפשרות הזו שימושית במקרים שבהם שותף הוא אתר אגרגטור, שלא הייתה לו אפשרות ליצור קשר עם המוֹכר.

TicketOrderExtension

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

ייצוג JSON 
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
שדות
ticketEvent

object (TicketEvent)

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

TicketEvent

מייצג אירוע יחיד.

ייצוג JSON 
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
שדות
type

enum (Type)

חובה: סוג האירוע בכרטיס, למשל: סרט או הופעה.

name

string

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

description

string

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

url

string

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

location

object (Location)

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

eventCharacters[]

object (EventCharacter)

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

startDate

object (Time)

שעת התחלה.

endDate

object (Time)

שעת סיום.

doorTime

object (Time)

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

תיאור

סוג האירוע.

טיפוסים בני מנייה (enums)
EVENT_TYPE_UNKNOWN סוג אירוע לא ידוע.
MOVIE סרט.
CONCERT הופעה.
SPORTS ספורט.

EventCharacter

דמות אחת באירוע, למשל מארגן, אמן וכו'.

ייצוג JSON 
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
שדות
type

enum (Type)

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

name

string

שם הדמות.

image

object (Image)

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

תיאור

סוג התו.

טיפוסים בני מנייה (enums)
TYPE_UNKNOWN סוג לא ידוע.
ACTOR שחקן.
PERFORMER אומן.
DIRECTOR במאי.
ORGANIZER מארגן.