- ייצוג JSON
- UserInfo
- PhoneNumber
- תמונה
- מוֹכר
- מיקום
- LatLng
- PostalAddress
- תוכן עניינים
- LineItem
- PriceAttribute
- סוג
- מדינה
- Money
- פעולה
- סוג
- OpenUrlAction
- AndroidApp
- VersionFilter [מסנן גרסאות]
- UrlTypeHint
- ActionMetadata
- גילוי נאות
- DisclosureText
- TextLink
- DisclosurePresentationOptions (הצגת אפשרויות מצגת)
- PresentationRequirement
- PurchaseItemExtension
- PurchaseStatus
- PurchaseType
- MerchantUnitMeasure
- היחידה
- PurchaseReturnsInfo
- PurchaseFulfillmentInfo
- סוג
- זמן
- PickupInfo
- PickupType
- CurbsideInfo
- CurbsideFulfillmentType
- רכב
- CheckInInfo
- CheckInType
- ItemOption
- ProductDetails
- ReservationItemExtension
- ReservationStatus
- ReservationType
- StaffFacilitator
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- PaymentType
- PaymentMethodProvenance
- מבצע
- PurchaseOrderExtension
- PurchaseLocationType
- PurchaseError
- ErrorType
- TicketOrderExtension
- TicketEvent
- סוג
- EventCharacter
- סוג
ישות ההזמנה. הערה: 1. כל המחרוזות בכל הרמות חייבות להיות באורך של פחות מ-1,000 תווים, אלא אם צוין אחרת. 2. כל השדות החוזרים בכל הרמות חייבים להיות קטנים מ-50, אלא אם צוין אחרת. 3. אם מציינים את כל חותמות הזמן בכל הרמות, הן חייבות להיות חותמות זמן תקינות.
ייצוג JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
שדות | ||
---|---|---|
googleOrderId |
מזהה ההזמנה שהוקצה על ידי Google. |
|
merchantOrderId |
חובה: מזהה הזמנה פנימי שהוקצה על ידי המוכר. המזהה הזה צריך להיות ייחודי, והוא נדרש לפעולות הבאות של עדכון הזמנה. אפשר להגדיר את המזהה הזה ל-googleOrderId שצוין או לכל ערך ייחודי אחר. שימו לב שהמזהה שמוצג למשתמשים הוא uservisibleOrderId, שעשוי להיות ערך שונה וידידותי יותר למשתמש. האורך המקסימלי המותר הוא 128 תווים. |
|
userVisibleOrderId |
המזהה שגלוי למשתמש שמתייחס להזמנה הנוכחית. המזהה הזה צריך להיות תואם למזהה שמוצג בהזמנה הזו בהקשרים אחרים, כולל אתרים, אפליקציות ואימייל. |
|
userVisibleStateLabel |
הוצא משימוש: יש להשתמש בסטטוס של תוספי הזמנה. תווית גלויה למשתמש של מצב ההזמנה הזו. |
|
buyerInfo |
מידע על הקונה. |
|
image |
תמונה שמשויכת להזמנה. |
|
createTime |
חובה: התאריך והשעה שבהם ההזמנה נוצרה. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
|
lastUpdateTime |
התאריך והשעה שבהם ההזמנה עודכנה לאחרונה. נדרש עבור OrderUpdate. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
|
transactionMerchant |
המוכר שאפשר את התשלום בקופה. הספק יכול להיות שונה מספק ברמת הפריט. דוגמה: הזמנת Expedia עם פריט מ-ANA. |
|
contents |
נדרש: תוכן ההזמנה שהוא קבוצה של פריטים. |
|
priceAttributes[] |
מחיר, הנחות, מיסים וכו'. |
|
followUpActions[] |
פעולות מעקב ברמת ההזמנה. |
|
paymentData |
נתונים שקשורים לתשלום של ההזמנה. |
|
termsOfServiceUrl |
קישור לתנאים ולהגבלות שחלים על הזמנה/הזמנה מוצעת. |
|
note |
הערות המצורפות להזמנה. |
|
promotions[] |
כל קידומי המכירות המשויכים להזמנה הזו. |
|
disclosures[] |
הודעות גילוי נאות המשויכות להזמנה הזו. |
|
vertical |
הוצא משימוש: יש להשתמש בעמודות במקום זאת. המאפיינים האלה יחולו על כל הפריטים, אלא אם הם יבוטלו בפריט מסוים. הקטגוריה הזו חייבת להתאים לסוג האנכי ברמת הפריט. ערכים אפשריים: אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
|
שדה איחוד verticals . המאפיינים האלה יחולו על כל הפריטים, אלא אם הם יבוטלו בפריט מסוים. הקטגוריה הזו חייבת להתאים לסוג האנכי ברמת הפריט. הערך של verticals יכול להיות רק אחת מהאפשרויות הבאות: |
||
purchase |
הזמנת רכש |
|
ticket |
הזמנת כרטיסים |
UserInfo
מידע על המשתמש. משמש לייצוג מידע של המשתמש שמשויך להזמנה.
ייצוג JSON | |
---|---|
{
"email": string,
"firstName": string,
"lastName": string,
"displayName": string,
"phoneNumbers": [
{
object ( |
שדות | |
---|---|
email |
כתובת האימייל של המשתמש, למשל: janedoe@gmail.com. |
firstName |
השם הפרטי של המשתמש. |
lastName |
שם המשפחה של המשתמש. |
displayName |
השם המוצג של המשתמש עשוי להיות שונה מהשם הפרטי או משם המשפחה. |
phoneNumbers[] |
מספרי הטלפון של המשתמש. |
PhoneNumber
ייצוג סטנדרטי של מספרי טלפון.
ייצוג JSON | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
שדות | |
---|---|
e164PhoneNumber |
מספר טלפון בפורמט E.164, כפי שמוגדר בהמלצה E.164 של איגוד הטלקומוניקציה הבינלאומי (ITU). קישור לוויקיפדיה: https://en.wikipedia.org/wiki/E.164 |
extension |
תוסף אינו סטנדרטי בהמלצות של ITU, אלא אם הוא מוגדר כסדרת מספרים באורך מקסימלי של 40 ספרות. הוא מוגדר כאן כמחרוזת כדי להתאים לשימוש אפשרי באפס מוביל בתוסף (לארגונים יש חופש מלא לעשות זאת, מכיוון שלא הוגדר תקן). מלבד ספרות, אפשר לשמור כאן תווי חיוג אחרים כמו ',' (המצביעים על המתנה). לדוגמה, בדוגמה xxx-xxx-xxxx ext. 123, '123' הוא התוסף. |
preferredDomesticCarrierCode |
קוד הבחירה של הספק המועדף כשמתקשרים למספר הטלפון המקומי. בהגדרה הזו נכללים גם קודים שצריך לחייג במדינות מסוימות כשמתקשרים מקווים נייחים לנייד או להפך. לדוגמה, בקולומביה, צריך לחייג את המספר "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 |
כתובת ה-URL המקורית של התמונה. התמונות יכולות להיות בפורמט JPG, PNG ו-GIF (מונפשים או ללא אנימציה). לדוגמה, |
accessibilityText |
תיאור טקסטואלי של התמונה שתשמש לצורך נגישות, למשל קוראי מסך. חובה. |
height |
גובה התמונה בפיקסלים. אפשרות. |
width |
רוחב התמונה בפיקסלים. אפשרות. |
מוֹכר
המוכר של עגלת הקניות/ההזמנה/הפריט.
ייצוג JSON | |
---|---|
{ "id": string, "name": string, "image": { object ( |
שדות | |
---|---|
id |
המזהה האופציונלי מוקצה למוכר, אם יש כזה. |
name |
שם המוכר, כמו "לחם פנרה". |
image |
התמונה שמשויכת למוכר. |
phoneNumbers[] |
מספרי הטלפון של המוכרים. |
address |
כתובת המוכר. |
מיקום
מאגר שמייצג מיקום.
ייצוג JSON | |
---|---|
{ "coordinates": { object ( |
שדות | |
---|---|
coordinates |
קואורדינטות גיאוגרפיות. נדרשת ההרשאה [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
formattedAddress |
כתובת לתצוגה, לדוגמה: "1600 Amphitheatre Pkwy, Mountain View, CA 94043". נדרשת ההרשאה [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
zipCode |
מיקוד. נדרשת ההרשאה [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] או [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
city |
עיר. נדרשת ההרשאה [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] או [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
postalAddress |
כתובת לדברי דואר. נדרשת ההרשאה [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] או [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
name |
שם המקום. |
phoneNumber |
מספר הטלפון של המיקום, למשל מספר הטלפון של מיקום העסק או מספר הטלפון של מיקום המשלוח. |
notes |
הערות לגבי המיקום. |
placeId |
PlaceId משמש לאחזור פרטים על מקום באמצעות Places API. פרטים נוספים זמינים בכתובת https://developers.google.com/places/web-service/place-id |
LatLng
אובייקט שמייצג צמד של קו רוחב/קו אורך. ערך זה מבוטא כצמד זוגות של מעלות קו רוחב ומעלות קו אורך. אם לא צוין אחרת, חובה לעמוד בתקן WGS84. הערכים חייבים להיות בטווחים מנורמלים.
ייצוג JSON | |
---|---|
{ "latitude": number, "longitude": number } |
שדות | |
---|---|
latitude |
קו הרוחב במעלות. הערך חייב להיות בטווח של [ -90.0, +90.0]. |
longitude |
קו האורך במעלות. הוא צריך להיות בטווח של [ -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 |
גרסת הסכימה של כל הגרסאות החדשות חייבות להיות תואמות לאחור לגרסאות הישנות. |
regionCode |
חובה. קוד האזור במאגר CLDR של המדינה/האזור של הכתובת. אין אפשרות להסיק מידע זה בעבר, ובאחריות המשתמש לוודא שהערך נכון. פרטים נוספים זמינים ב-http://cldr.unicode.org/ וב-http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. דוגמה: 'CH' עבור שווייץ. |
languageCode |
אפשרות. קוד השפה BCP-47 של תוכן הכתובת הזו (אם ידוע). לרוב זו שפת ממשק המשתמש בטופס הקלט, או שהשפה צפויה להיות תואמת לאחת מהשפות שנמצאות בשימוש במדינה/באזור של הכתובת, או מקבילות בתמליל שלהן. זה יכול להשפיע על הפורמט במדינות מסוימות, אבל הוא לא קריטי לתקינות הנתונים ולעולם לא ישפיע על אימות או על פעולות אחרות שלא קשורות לפורמט. אם הערך לא ידוע, יש להשמיט אותו (במקום לציין ברירת מחדל שעלולה להיות שגויה). דוגמאות: 'zh-Hant', 'ja', 'ja-Latn', 'en'. |
postalCode |
אפשרות. המיקוד בכתובת. לא בכל המדינות נעשה שימוש במספרי מיקוד, או שנדרשות קיומם, אבל במקומות שבהם משתמשים בהם ייתכן שיופעל אימות נוסף בחלקים אחרים של הכתובת (למשל מדינה/אימות מיקוד בתוך ארה"ב). |
sortingCode |
אפשרות. קוד מיון נוסף, ספציפי למדינה. האפשרות הזו לא נמצאת בשימוש ברוב האזורים. כאשר משתמשים בו, הערך הוא מחרוזת כמו "CEDEX", ואופציונלית גם אחרי מספר (למשל "CEDEX 7"), או רק מספר בלבד שמייצג את "קוד המגזר" (ג'מייקה), "אינדיקטור אזור המשלוחים " (מלאווי) או"אינדיקטור לסניף דואר" (למשל חוף השנהב). |
administrativeArea |
אפשרות. חלוקת המשנה הניהולית הגבוהה ביותר, המשמשת לכתובות דואר של מדינה או אזור. לדוגמה, המדינה יכולה להיות מדינה, פרובינציה, אובלסט או נפה. באופן ספציפי, בספרד זהו המחוז ולא הקהילה האוטונומית (למשל, "ברצלונה" ולא "קטלוניה"). במדינות רבות לא משתמשים באזור מנהלי בכתובות דואר. למשל, בשווייץ צריך להשאיר את השדה הזה לא מאוכלס. |
locality |
אפשרות. המונח 'בדרך כלל' מתייחס לחלק העיר/העיירה של הכתובת. דוגמאות: עיר בארה"ב, קומוניית IT, עיר דואר בבריטניה. באזורים בעולם שבהם הרשויות המוניציפאליות אינן מוגדרות היטב או שאינן מתאימות למבנה זה, השאירו את הרשות המוניציפאלית ריקה והשתמשו ב-addressLines. |
sublocality |
אפשרות. מיקום המשנה של הכתובת. לדוגמה: שכונות, רובעים או מחוזות. |
addressLines[] |
שורות כתובת לא מובנות שמתארות את הרמות הנמוכות יותר בכתובת. מכיוון שערכים ב-addressLines לא כוללים פרטי סוג, הם עשויים להכיל לפעמים ערכים מרובים בשדה יחיד (למשל, "Austin, TX"), חשוב שסדר השורות יהיה ברור. סדר השורות צריך להיות 'הזמנת מעטפה' למדינה/אזור של הכתובת. במקומות שבהם זה יכול להשתנות (למשל ביפן), address_language משמש כדי לציין את הטקסט המפורש (למשל 'ja' לסידור מגדול לקטן ו-'ja-Latn' או 'en' מגודל קטן ל-גדול). כך אפשר לבחור את השורה הספציפית ביותר של הכתובת בהתאם לשפה. הייצוג המבני המינימלי המותר של כתובת כולל קוד regionCode שבו כל המידע שנותר מופיע ב-addressLines. ניתן היה לעצב כתובת כזו באופן קרוב מאוד ללא קידוד גיאוגרפי, אבל לא ניתן היה לספק נימוק סמנטי לגבי רכיבי הכתובת עד שהבעיה תיפתר לפחות באופן חלקי. הדרך המומלצת לטיפול בכתובות לא מובנות לחלוטין היא יצירת כתובת הכוללת קוד regionCode ו-addressLines בלבד ולאחר מכן קידוד גיאוגרפי (בניגוד לנחש אילו חלקים של הכתובת צריכים להיות רשויות מקומיות או אזורים מנהליים). |
recipients[] |
אפשרות. הנמען בכתובת. בנסיבות מסוימות שדה זה עשוי להכיל מידע מרובה שורות. לדוגמה, הוא עשוי להכיל מידע מסוג 'טיפול'. |
organization |
אפשרות. שם הארגון בכתובת. |
תוכן עניינים
ראפ לפריטים.
ייצוג JSON | |
---|---|
{
"lineItems": [
{
object ( |
שדות | |
---|---|
lineItems[] |
רשימת הפריטים בהזמנה. יש לציין פריט line_item אחד לפחות, ואפשר להזין 50 לכל היותר. כל הפריטים חייבים להשתייך לאותה תעשייה. |
LineItem
פריט אחד מכיל אנכי אחד. הזמנה או עגלה יכולים לכלול מספר פריטים באותה תעשייה. יש להגדיר פריטי משנה/תוספות וכו' בפרוטוקולים אנכיים בהתאם לתרחישי השימוש שלהם. הערה: 1. כל המחרוזות בכל הרמות חייבות להיות באורך של פחות מ-1,000 תווים, אלא אם צוין אחרת. 2. כל השדות החוזרים בכל הרמות חייבים להיות קטנים מ-50, אלא אם צוין אחרת. 3. אם מציינים את כל חותמות הזמן בכל הרמות, הן חייבות להיות חותמות זמן תקינות.
ייצוג JSON | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
שדות | ||
---|---|---|
id |
חובה: מזהה שהוקצה על ידי המוכר לפריט. משמש לזיהוי פריט קיים בהחלת עדכונים חלקיים. האורך המקסימלי המותר הוא 64 תווים. |
|
name |
שם הפריט כפי שמוצג בקבלה. האורך המקסימלי המותר הוא 100 תווים. |
|
userVisibleStateLabel |
הוּצא משימוש. במקום זאת, אפשר להשתמש בסטטוס ברמה אנכית. לדוגמה, עבור רכישות, השתמש ב-PurchaseOrderExtension.status. תווית מצב גלויה למשתמש של מצב הפריט. |
|
provider |
הספק של הפריט המסוים, אם הוא שונה מההזמנה הכוללת. לדוגמה: הזמנה ב-Expedia עם ספק הפריטים ANA. |
|
priceAttributes[] |
המחיר וההתאמות ברמת הפריט. |
|
followUpActions[] |
פעולות המשך בפריט. |
|
recipients[] |
לקוחות ברמת הפריט, ייתכן שזה יהיה שונה מהקונה ברמת ההזמנה. דוגמה: משתמש X ביצע הזמנה במסעדה בשם משתמש Y. |
|
image |
תמונה קטנה שמשויכת לפריט הזה, אם יש כזה. |
|
description |
תיאור הפריט. |
|
notes[] |
הערות נוספות שרלוונטיות לפריט הספציפי הזה, לדוגמה, מדיניות הביטולים. |
|
disclosures[] |
הודעות גילוי נאות המשויכות לפריט הזה. |
|
vertical |
הוצא משימוש: יש להשתמש בעמודות במקום זאת. חובה: התוכן הסמנטי של הפריט על סמך הסוג או הקטגוריה שלו. כל קטגוריה צריכה לכלול פרטים משלה על מילוי הזמנות. חייב להיות אחד מהערכים הבאים: אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
|
שדה איחוד verticals . חובה: התוכן הסמנטי של הפריט על סמך הסוג או הקטגוריה שלו. כל קטגוריה צריכה לכלול פרטים משלה על מילוי הזמנות. הערך של verticals יכול להיות רק אחת מהאפשרויות הבאות: |
||
purchase |
הזמנות רכש כמו מוצרים, אוכל וכו' |
|
reservation |
הזמנות מקום כמו מסעדה, תספורת וכו' |
PriceAttribute
מאפיין מחיר של הזמנה או פריט.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | ||
---|---|---|
type |
חובה: מאפיין סוג הכסף. |
|
name |
חובה: המשתמש מציג מחרוזת של מאפיין המחיר. המזהה נשלח ומותאם לשוק המקומי על ידי המוֹכר. |
|
state |
חובה: מצב המחיר: אומדן לעומת בפועל. |
|
taxIncluded |
האם המחיר כולל מס. |
|
שדה איחוד spec . מייצג סכום כספי או אחוז מילימטרים. הערך של spec יכול להיות רק אחת מהאפשרויות הבאות: |
||
amount |
סכום כספי. |
|
amountMillipercentage |
המפרט של האחוז, עד ל-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 |
קוד המטבע בן 3 אותיות כפי שמוגדר בתקן ISO 4217. |
amountInMicros |
הסכום במיליוניות השנייה. לדוגמה, יש להגדיר את השדה הזה כ-1990000 עבור $1.99. |
פעולה
פעולת המשך שמשויכת להזמנה או לפריט.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
חובה: סוג הפעולה. |
title |
השם או התווית של הפעולה, שמוצגים למשתמש. האורך המקסימלי המותר הוא 100 תווים. |
openUrlAction |
הפעולה לביצוע. |
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 ( |
שדות | |
---|---|
url |
שדה כתובת ה-URL שיכול להיות כל אחד מהפרטים הבאים: - כתובות URL מסוג http/https לפתיחת אפליקציה או דף אינטרנט שמקושרים לאפליקציה |
androidApp |
מידע על האפליקציה ל-Android, אם האפליקציה ל-Android צפויה למלא את כתובת ה-URL. |
urlTypeHint |
מציין רמז לסוג כתובת האתר. |
AndroidApp
מפרט האפליקציה ל-Android לגבי הגבלות מילוי ההזמנה
ייצוג JSON | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
שדות | |
---|---|
packageName |
כשמציינים את שם החבילה, יש לציין את שם החבילה. |
versions[] |
אם ציינתם כמה מסננים, כל התאמת מסנן תפעיל את האפליקציה. |
VersionFilter
יש לכלול VersionFilter אם יש צורך בגרסאות ספציפיות של האפליקציה.
ייצוג JSON | |
---|---|
{ "minVersion": number, "maxVersion": number } |
שדות | |
---|---|
minVersion |
קוד גרסה מינימלית או 0, כולל. |
maxVersion |
קוד גרסה מקסימלית, כולל. הטווח שיש להתייחס אליו הוא [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 |
השעה שבה הפעולה הזו תפוג. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
גילוי נאות
גילוי נאות לגבי מוצר, שירות או מדיניות שעשוי להיות מוצג למשתמש.
ייצוג JSON | |
---|---|
{ "title": string, "disclosureText": { object ( |
שדות | |
---|---|
title |
שם הגילוי הנאות. דוגמה: "מידע על בטיחות". |
disclosureText |
תוכן הגילוי הנאות. מותר להוסיף קישורי אינטרנט. |
presentationOptions |
אפשרויות הצגה של הגילוי הנאות. |
DisclosureText
מייצג טקסט פשוט עם קישורי אינטרנט.
ייצוג JSON | |
---|---|
{
"template": string,
"textLinks": [
{
object ( |
שדות | |
---|---|
template |
טקסט לתצוגה, שכולל מצייני מיקום כגון "{0}" ו-"{1}" לכל קישור טקסט שצריך להוסיף. דוגמה: "אזהרה: מוצר זה עלול לחשוף אותך לחומרים כימיים שידועים למדינת קליפורניה כגורמים לסרטן. לקבלת מידע נוסף, עבור אל {0}." אסור לכלול בטקסט של הגילוי הנאות תוכן שיווקי או תוכן שדומה למודעה. |
textLinks[] |
קישורי טקסט שיש להחליף בתבנית. המחרוזת הראשונה תוחלף ב-"{0}" במחרוזת התבנית, והמזהה השני יוחלף ב-"{1}" וכו'. |
TextLink
קישור טקסט שצריך להחליף בתבנית.
ייצוג JSON | |
---|---|
{ "displayText": string, "url": string } |
שדות | |
---|---|
displayText |
טקסט שצריך להציג למשתמשים. |
url |
כתובת ה-URL שאליה המשתמשים יופנו לאחר הפעלת הקישור. |
DisclosurePresentationOptions
אפשרויות להצגת גילוי נאות.
ייצוג JSON | |
---|---|
{
"presentationRequirement": enum ( |
שדות | |
---|---|
presentationRequirement |
הדרישה להציג את מסמך הגילוי הנאות. |
initiallyExpanded |
האם יש להרחיב את התוכן של הגילוי הנאות בהתחלה. כברירת מחדל, המערכת מכווצת אותה בהתחלה. |
PresentationRequirement
דרישה להצגת הגילוי הנאות.
טיפוסים בני מנייה (enums) | |
---|---|
REQUIREMENT_UNSPECIFIED |
דרישה לא מוגדרת. אין להגדיר זאת במפורש. |
REQUIREMENT_OPTIONAL |
הגילוי הנאות הוא אופציונלי. ניתן לדלג עליו אם המכשיר לא תומך בהצגת גילויים נאותים. |
REQUIREMENT_REQUIRED |
הגילוי הנאות הוא חובה. השיחה תופנה לטלפון אם המכשיר לא תומך בהצגת גילויים נאותים. |
PurchaseItemExtension
תוכן הפריט בקטגוריית הרכישה.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
נדרש: סטטוס ברמת הפריט. |
userVisibleStatusLabel |
חובה: תווית/מחרוזת גלויים למשתמש לסטטוס. האורך המקסימלי המותר הוא 50 תווים. |
type |
חובה: סוג הרכישה. |
productId |
מזהה המוצר או המבצע שמשויך לפריט הזה. |
quantity |
כמות הפריט. |
unitMeasure |
מידת יחידה. מאפיין זה מציין את גודל הפריט ביחידות שנבחרו. המחיר ליחידה, ביחד עם המחיר הפעיל, משמש לקביעת המחיר. |
returnsInfo |
מחזירה מידע על הפריט הזה. אם המדיניות לא מוגדרת, הפריט הזה יורש את רמת ההזמנה ומחזירה מידע. |
fulfillmentInfo |
פרטי האספקה של הפריט הזה. אם המדיניות לא מוגדרת, הפריט הזה יורש את פרטי האספקה ברמת ההזמנה. |
itemOptions[] |
תוספים או פריטי משנה נוספים. |
extension |
כל השדות הנוספים שיועברו בין המוכר ל-Google. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
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 ( |
שדות | |
---|---|
measure |
ערך: דוגמה 1.2. |
unit |
יחידה: דוגמה ל-POUND, GRAM. |
יחידה
טיפוסים בני מנייה (enums) | |
---|---|
UNIT_UNSPECIFIED |
היחידה לא צוינה. |
MILLIGRAM |
מיליגרם. |
GRAM |
גרם |
KILOGRAM |
קילוגרם. |
OUNCE |
אונקיה. |
POUND |
לירה סטרלינג |
PurchaseReturnsInfo
מחזירה מידע המשויך להזמנה או לפריט מסוים.
ייצוג JSON | |
---|---|
{ "isReturnable": boolean, "daysToReturn": number, "policyUrl": string } |
שדות | |
---|---|
isReturnable |
אם הערך הוא true, אפשר להחזיר אותו. |
daysToReturn |
ניתן להחזיר פריטים בתוך מספר הימים הזה. |
policyUrl |
קישור למדיניות החזרת המוצרים. |
PurchaseFulfillmentInfo
מידע על מילוי הזמנות שמשויך להזמנת רכש או לפריט מסוים.
ייצוג JSON | |
---|---|
{ "id": string, "fulfillmentType": enum ( |
שדות | |
---|---|
id |
המזהה הייחודי של אפשרות השירות הזו. |
fulfillmentType |
חובה: סוג האספקה. |
expectedFulfillmentTime |
חלון אם צוין טווח זמן, או זמן הגעה משוער אם צוין זמן אחד. מועד המסירה או האיסוף הצפוי. |
expectedPreparationTime |
חלון אם צוין טווח זמן, או זמן הגעה משוער אם צוין זמן אחד. הזמן הצפוי להכין את האוכל. עדיפות לחד-פעמי. |
location |
מיקום איסוף או משלוח. |
expireTime |
השעה שבה יפוג התוקף של אפשרות מילוי ההזמנה. חותמת זמן בפורמט "זולו" RFC3339 UTC, מדויקת לננו-שניות. דוגמה: |
price |
העלות של אפשרות זו. |
fulfillmentContact |
איש הקשר של המשתמש למילוי הבקשה. |
shippingMethodName |
השם של שיטת המשלוח שנבחרה על ידי המשתמש. |
storeCode |
קוד החנות של המיקום. דוגמה: Walmart הוא המוכר ו-storeCode הוא חנות walmart שבה בוצעה מילוי ההזמנה. https://support.google.com/business/answer/3370250?ref_topic=4596653. |
pickupInfo |
מידע נוסף לגבי אופן בחירת ההזמנה. השדה הזה רלוונטי רק כאשר סוג מילוי ההזמנה הוא PICKUP. |
תיאור
סוג האספקה.
טיפוסים בני מנייה (enums) | |
---|---|
TYPE_UNSPECIFIED |
הסוג לא צוין. |
DELIVERY |
ההזמנה הזו תסופק. |
PICKUP |
יש לאסוף את ההזמנה הזו. |
שעה
מבנה זמן שמייצג את השעה של אירוע לשימוש בעת הצגת הזמנה למשתמש.
ייצוג JSON | |
---|---|
{ "timeIso8601": string } |
שדות | |
---|---|
timeIso8601 |
מייצג מועד של אירוע ההזמנה, כמו זמן ההזמנה, זמן האספקה וכן הלאה. זה יכול להיות משך זמן (שעת התחלה ושעת סיום), רק התאריך, תאריך ושעה וכו'. אפשר לעיין ב-https://en.wikipedia.org/wiki/ISO_8601 לכל הפורמטים הנתמכים. |
PickupInfo
פרטים על אופן האיסוף של ההזמנה. הדוח כולל פרטים כמו סוג האיסוף ומטא-נתונים נוספים שמצורפים לכל סוג, אם יש.
ייצוג JSON | |
---|---|
{ "pickupType": enum ( |
שדות | |
---|---|
pickupType |
שיטת איסוף, כמו INSTORE, CURBSIDE וכו'. |
curbsideInfo |
פרטים שספציפיים למידע שבדלת העסק. אם PickType אינו "CURBSIDE", המערכת תתעלם מהשדה הזה. |
checkInInfo[] |
רשימת השיטות השונות שנתמכות על ידי השותף לצורך צ'ק-אין. |
PickupType
רשימה של סוגי האיסוף הנתמכים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין סוג האיסוף. |
INSTORE |
לאסוף אוכל מתוך המסעדה. |
CURBSIDE |
יש לחנות רכב במקום ייעודי מחוץ למסעדה, ומישהו היה מספק שם משלוח. |
CurbsideInfo
פרטים על האופן שבו תתאפשר הזמנה מדלת העסק.
ייצוג JSON | |
---|---|
{ "curbsideFulfillmentType": enum ( |
שדות | |
---|---|
curbsideFulfillmentType |
השותפים זקוקים למידע נוסף כדי לאפשר הזמנות באיסוף מדלת העסק. בהתאם לסוג מילוי הבקשה שנבחר, הפרטים התואמים ייאספו מהמשתמש. |
userVehicle |
פרטי הרכב של המשתמש שביצע את ההזמנה. |
CurbsideFulfillmentType
ערכים אפשריים של סוגי מילוי הזמנות במדרכה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין סוג מילוי ההזמנה מדלת העסק. |
VEHICLE_DETAIL |
כדי לאפשר איסוף מדלת העסק, נדרשים פרטי הרכב. |
כלי רכב
פרטים על רכב
ייצוג JSON | |
---|---|
{
"make": string,
"model": string,
"licensePlate": string,
"colorName": string,
"image": {
object ( |
שדות | |
---|---|
make |
יצרן הרכב (למשל "הונדה"). התיאור הזה מוצג למשתמש וצריך להתאים אותו לשוק המקומי. חובה. |
model |
דגם הרכב (למשל "Grom"). התיאור הזה מוצג למשתמש וצריך להתאים אותו לשוק המקומי. חובה. |
licensePlate |
מספר לוחית הרישוי של הרכב (למשל: 1ABC234). חובה. |
colorName |
שם צבע הרכב, למשל שחור אופציונלי. |
image |
כתובת URL של תמונה של הרכב. התמונה תוצג בגודל של כ-256x256 פיקסלים. JPG או PNG. אפשרות. |
CheckInInfo
מטא-נתונים שהשותף דורש כדי לתמוך בשיטת צ'ק-אין.
ייצוג JSON | |
---|---|
{
"checkInType": enum ( |
שדות | |
---|---|
checkInType |
השיטה שמשמשת לשליחת הוראות צ'ק-אין. |
CheckInType
מספר שיטות שונות שמשמשות לשליחת הוראות כניסה.
טיפוסים בני מנייה (enums) | |
---|---|
CHECK_IN_TYPE_UNSPECIFIED |
ערך לא ידוע. |
EMAIL |
פרטי הצ'ק אין יישלחו באימייל. |
SMS |
פרטי הצ'ק אין יישלחו ב-SMS. |
ItemOption
מייצג תוספים או פריטי משנה.
ייצוג JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
שדות | |
---|---|
id |
לאפשרויות שהן פריטים, מזהה פריט ייחודי. |
name |
שם האפשרות. |
prices[] |
המחיר הכולל של האופציה. |
note |
הערה שקשורה לאפשרות. |
quantity |
לאפשרויות שהן פריטים, quantity. |
productId |
מזהה המוצר או המבצע שמשויך לאפשרות הזו. |
subOptions[] |
כדי להגדיר אפשרויות משנה אחרות בתוך רכיב. |
ProductDetails
פרטים על המוצר.
ייצוג JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
שדות | |
---|---|
productId |
מזהה המוצר או המבצע שמשויך לפריט הזה. |
gtin |
מספר הפריט המסחרי הגלובלי של המוצר. שימושי אם OfferId לא קיים ב-Merchant Center. אפשרות. |
plu |
קודים לחיפוש מחירים, שנקראים בדרך כלל קודי PLU, מספרי PLU, PLU, קודים לייצור או תוויות לתוצרת חקלאית, הם מערכת של מספרים שמזהים באופן ייחודי את התוצרת החקלאית שנמכרה בחנויות מכולת ובסופרמרקטים. |
productType |
קטגוריית המוצר שהוגדרה על ידי המוֹכר. למשל, "Home > מכולת > חלב וביצים > חלב > חלב מלא" |
productAttributes |
פרטים שהמוכר סיפק לגבי המוצר, למשל { "allergen": "peanut" }. שימושי אם OfferId לא נמצא ב-Merchant Center. אפשרות. אובייקט שמכיל רשימה של |
ReservationItemExtension
תוכן של פריטים בהזמנות בהזמנה כמו מסעדה, תספורת וכו'. המזהה הבא: 15.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
חובה: סטטוס הזמנה. |
userVisibleStatusLabel |
חובה: תווית/מחרוזת גלויים למשתמש לסטטוס. האורך המקסימלי המותר הוא 50 תווים. |
type |
סוג ההזמנה. אפשר לבטל את ההגדרה אם אף אחת מאפשרויות הסוגים לא רלוונטית. |
reservationTime |
השעה שבה השירות או האירוע מתוזמנים להתרחש. יכול להיות טווח זמן, תאריך או שעה מדויקת. |
userAcceptableTimeRange |
טווח הזמנים המקובל על המשתמש. |
confirmationCode |
קוד האישור של ההזמנה הזו. |
partySize |
מספר האנשים. |
staffFacilitators[] |
מנהלי צוות שיטפלו בהזמנה. דוגמה: מעצב השיער. |
location |
מיקום השירות או האירוע. |
extension |
כל השדות הנוספים שיועברו בין המוכר ל-Google. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
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 ( |
שדות | |
---|---|
name |
השם של מנחה הצוות. דוגמה: "ישראל ישראלי" |
image |
התמונות של האומן. |
PaymentData
נתוני תשלום שקשורים להזמנה.
ייצוג JSON | |
---|---|
{ "paymentResult": { object ( |
שדות | |
---|---|
paymentResult |
תוצאת תשלום המשמשת את השילוב להשלמת עסקה. השדה הזה יאוכלס על ידי Actions on Google אם חוויית התשלום מנוהלת על ידי Actions-on-Google. |
paymentInfo |
פרטי תשלום בנוגע להזמנה שעוזרים לאינטראקציה מול המשתמש. |
PaymentResult
תוצאת תשלום המשמשת את השילוב להשלמת עסקה.
ייצוג JSON | |
---|---|
{ // Union field |
שדות | ||
---|---|---|
שדה איחוד result . סיפקת נתוני תשלום מ-Google או אמצעי תשלום של מוכר. הערך של result יכול להיות רק אחת מהאפשרויות הבאות: |
||
googlePaymentData |
נתונים של אמצעי התשלום ש-Google סיפקה. אם ספק שירותי התשלומים שלכם רשום בתור ספק שירותי התשלומים הנתמך על ידי Google: https://developers.google.com/pay/api/, ניתן לעבור אל ספק שירותי התשלומים שלכם באמצעות הקישור כדי לקבל פרטים נוספים. אם לא, כדאי לעיין במסמכים הבאים בנושא פרטי מטען ייעודי (payload). https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
אמצעי התשלום שסופק על ידי המוכר או הפעולה שנבחרה על ידי המשתמש. |
PaymentInfo
פרטי התשלום בנוגע להזמנה שבוצעה. הפרוטו הזה לוכד מידע שימושי לאינטראקציה מול המשתמש.
ייצוג JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
שדות | |
---|---|
paymentMethodDisplayInfo |
פרטי אמצעי התשלום ששימש לביצוע העסקה. |
paymentMethodProvenance |
המקור של אמצעי התשלום ששימש לעסקה. יכול להיות שהמשתמש רשם את אותו אמצעי תשלום גם ב-Google וגם במוכר. |
PaymentMethodDisplayInfo
תוצאת תשלום המשמשת את השילוב להשלמת עסקה.
ייצוג JSON | |
---|---|
{
"paymentType": enum ( |
שדות | |
---|---|
paymentType |
סוג התשלום. |
paymentMethodDisplayName |
השם של אמצעי התשלום שגלוי למשתמש. לדוגמה, VISA **** 1234 חשבון עו"ש **** 5678 |
paymentMethodVoiceName |
שם אמצעי התשלום שיוקרא למשתמש במכשירי 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 |
חובה: קוד השובר מומש על המבצע הזה. |
PurchaseOrderExtension
תוסף הזמנה לקטגוריית הרכישה. המאפיינים האלה רלוונטיים לכל הפריטים שנכללים בהזמנה, אלא אם הם בוטלו בפריט כלשהו.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
חובה: סטטוס כללי של ההזמנה. |
userVisibleStatusLabel |
תווית/מחרוזת גלויים למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים. |
type |
חובה: סוג הרכישה. |
returnsInfo |
החזרת פרטי ההזמנה. |
fulfillmentInfo |
פרטי אספקה של ההזמנה. |
extension |
כל השדות הנוספים שיועברו בין המוכר ל-Google. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
purchaseLocationType |
מיקום הרכישה (בחנות / באינטרנט) |
errors[] |
אופציונלי: שגיאות שגרמו לדחייה של ההזמנה. |
PurchaseLocationType
סוג המיקום של הרכישה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED_LOCATION |
ערך לא ידוע. |
ONLINE_PURCHASE |
כל הרכישות שנקנו באינטרנט. |
INSTORE_PURCHASE |
כל הרכישות בחנות. |
PurchaseError
שגיאות שגורמות לדחייה של הזמנת רכש.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
חובה: הערך הזה מייצג את הסיבה המפורטת שבגללה המוכר דחה הזמנה. |
description |
תיאור שגיאה נוסף. |
entityId |
מזהה הישות שתואם לשגיאה. לדוגמה, ערך זה יכול להתאים לערך LineItemId / ItemOptionId. |
updatedPrice |
רלוונטי במקרה של סוג שגיאה PRICE_Change / INCORRECT_PRICE. |
availableQuantity |
הכמות הזמינה עכשיו. רלוונטי במקרה של 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
מייצג אירוע יחיד.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
חובה: סוג האירוע בכרטיס, למשל: סרט או הופעה. |
name |
חובה: שם האירוע. לדוגמה, אם האירוע הוא סרט, השם צריך להיות שם הסרט. |
description |
תיאור האירוע. |
url |
כתובת ה-URL של פרטי האירוע. |
location |
המיקום שבו האירוע מתרחש או שבו ממוקם הארגון. |
eventCharacters[] |
התווים הקשורים לאירוע הזה. הוא יכול להיות במאי או שחקנים באירוע קולנוע, מבצעי קונצרטים וכו'. |
startDate |
שעת התחלה. |
endDate |
שעת סיום. |
doorTime |
שעת הכניסה, שעשויה להיות שונה משעת ההתחלה של האירוע. למשל, האירוע מתחיל ב-9:00 אבל שעת הכניסה היא 8:30. |
תיאור
סוג האירוע.
טיפוסים בני מנייה (enums) | |
---|---|
EVENT_TYPE_UNKNOWN |
סוג אירוע לא ידוע. |
MOVIE |
סרט. |
CONCERT |
הופעה. |
SPORTS |
ספורט. |
EventCharacter
דמות אחת באירוע, למשל מארגן, אמן וכו'.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
סוג הדמות באירוע, למשל שחקן או במאי. |
name |
שם הדמות. |
image |
תמונות של הדמות. |
תיאור
סוג התו.
טיפוסים בני מנייה (enums) | |
---|---|
TYPE_UNKNOWN |
סוג לא ידוע. |
ACTOR |
שחקן. |
PERFORMER |
אומן. |
DIRECTOR |
במאי. |
ORGANIZER |
מארגן. |