- ייצוג JSON
- UserInfo
- PhoneNumber
- תמונה
- מוֹכר
- מיקום
- LatLng
- PostalAddress
- תוכן עניינים
- LineItem
- PriceAttribute
- סוג
- מדינה (State)
- כסף
- פעולה
- סוג
- 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 |
הוצא משימוש: יש להשתמש בסטטוס Orderתוספים במקום זאת. תווית גלויה למשתמש של מצב ההזמנה הזו. |
|
buyerInfo |
מידע על הקונה. |
|
image |
תמונה שמשויכת להזמנה. |
|
createTime |
חובה: התאריך והשעה שבהם ההזמנה נוצרה. חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: |
|
lastUpdateTime |
התאריך והשעה שבהם ההזמנה עודכנה לאחרונה. נדרש עבור OrderUpdate. חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: |
|
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[] |
מספרי הטלפון של המשתמש. |
מספר טלפון
ייצוג סטנדרטי של מספר טלפון.
ייצוג JSON | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
שדות | |
---|---|
e164PhoneNumber |
מספר טלפון בפורמט E.164, כפי שמוגדר בהמלצה E.164 של איגוד הטלקומוניקציה הבינלאומי (ITU). קישור ל-wiki: https://en.wikipedia.org/wiki/E.164 |
extension |
התוסף לא סטנדרטי בהמלצות ITU, למעט שהן מוגדרות כסדרת מספרים עם אורך מקסימלי של 40 ספרות. היא מוגדרת כמחרוזת כאן כדי לאפשר שימוש אפשרי באפס בתחילת התוסף (לארגונים יש חופש מלא לעשות זאת, מכיוון שלא הוגדר תקן). מלבד ספרות, תווי חיוג אחרים כגון "," (מצביע על המתנה) ייתכן שיאוחסן כאן. לדוגמה, ב-xxx-xxx-xxxx. 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 |
שם המוכר, למשל "Panera Bread". |
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
מייצג כתובת למשלוח דואר, למשל עבור כתובות למשלוח דואר או תשלומים. אם תספקו כתובת למשלוח דואר, שירות הדואר יכול לשלוח פריטים לעסק שלכם, P.O. Box או דומה. הוא לא נועד לבנות מודלים של מיקומים גיאוגרפיים (כבישים, ערים, הרים).
בשימוש אופייני, כתובת תיווצר על ידי קלט של משתמשים או על ידי ייבוא נתונים קיימים, בהתאם לסוג התהליך.
עצות לגבי קלט / עריכה של כתובת: - השתמשו בווידג'ט של כתובת שמוכן ל-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, עיר דואר בבריטניה. באזורים בעולם שבהם רשויות מוניציפאליות לא מוגדרות היטב או שלא מתאימות למבנה הזה בצורה טובה, השאירו את הרשות המוניציפאלית ריקה והשתמשו בקווי כתובת. |
sublocality |
זה שינוי אופציונלי. אזור המשנה של הכתובת. לדוגמה, המאפיינים יכולים להיות שכונות, רובעים או מחוזות. |
addressLines[] |
שורות כתובת לא מובנות, שמתארות את הרמות הנמוכות יותר של כתובת. מכיוון שערכים ב-addressLines לא כוללים פרטי סוג ולפעמים הם עשויים להכיל ערכים מרובים בשדה יחיד (למשל "Austin, TX"), חשוב שסדר השורות יהיה ברור. סדר שורות הכתובת צריך להיות "סדר מעטפה" עבור המדינה/האזור של הכתובת. במקומות שבהם הערך הזה יכול להשתנות (למשל, יפן), משתמשים ב-address_language כדי לציין אותה באופן מפורש (למשל 'ja' לסידור מהגדול לקטן ו-'ja-Latn' או 'en' לקטן לגדול). כך ניתן לבחור את שורת הכתובת הספציפית ביותר בהתאם לשפה. הייצוג המבני המינימלי המותר של כתובת מורכב מ-regionCode עם כל שאר המידע שמוצב בשורות הכתובת. ניתן יהיה לעצב כתובת כזו באופן מאוד ללא קידוד גיאוגרפי, אבל לא ניתן יהיה לספק נימוק סמנטי לגבי אף אחד מרכיבי הכתובת עד לפתרון חלקי של הבעיה. יצירת כתובת שמכילה רק regionCode ושורות כתובת, ולאחר מכן קידוד גיאוגרפי היא הדרך המומלצת לטיפול בכתובות לא מובנות לחלוטין (בניגוד לניחוש אילו חלקים של הכתובת צריכים להיות רשויות מוניציפאליות או אזורים מנהליים). |
recipients[] |
זה שינוי אופציונלי. הנמען בכתובת. בנסיבות מסוימות השדה הזה יכול להכיל מידע על כמה שורות. לדוגמה, יכול להיות שהשם כולל את המונח 'טיפול ב-' מידע. |
organization |
זה שינוי אופציונלי. שם הארגון בכתובת. |
תוכן עניינים
wrapper של פריטים.
ייצוג JSON | |
---|---|
{
"lineItems": [
{
object ( |
שדות | |
---|---|
lineItems[] |
רשימה של פריטי הזמנה. יש להוסיף לפחות 50 שורות ולא יותר מ-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% מיוצג כ-8750, באחוזים שליליים מייצגים הנחות באחוזים. אנחנו מוציאים את השדה הזה משימוש. כדאי להוסיף חזרה כאשר יש צורך בתרחיש לדוגמה מוצק. |
סוג
מייצג את סוג הכסף.
טיפוסים בני מנייה (enum) | |
---|---|
TYPE_UNSPECIFIED |
הסוג לא צוין, הלקוחות לא צריכים להגדיר אותו במפורש. |
REGULAR |
המחיר הרגיל בתצוגה, לפני שאנחנו מחילים הנחות וכו'. |
DISCOUNT |
לניכוי מסכום הביניים. |
TAX |
כדי להתווסף לסיכום הביניים. |
DELIVERY |
כדי להתווסף לסיכום הביניים. |
SUBTOTAL |
סכום ביניים, לפני שיתווספו עמלות. |
FEE |
כל עמלה נוספת. |
GRATUITY |
כדי להתווסף לסיכום הביניים. |
TOTAL |
המחיר המוצג של ההזמנה או הפריט. |
מדינה
מייצג את מצב המחיר.
טיפוסים בני מנייה (enum) | |
---|---|
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 |
מטא-נתונים שמשויכים לפעולה. |
סוג
פעולות אפשריות להמשך.
טיפוסים בני מנייה (enum) | |
---|---|
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 מסוג http או https לפתיחת אפליקציה או דף אינטרנט שמקושרים לאפליקציה |
androidApp |
מידע על האפליקציה ל-Android, אם אפליקציה ל-Android צפויה למלא את כתובת ה-URL. |
urlTypeHint |
מציין רמז לסוג כתובת ה-URL. |
AndroidApp
מפרט האפליקציה ל-Android בנוגע להגבלות על מילוי הזמנות
ייצוג JSON | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
שדות | |
---|---|
packageName |
שם החבילה צריך לציין את שם החבילה כשמציינים את Android Fulfillment. |
versions[] |
אם ציינת כמה מסננים, כל התאמת מסנן תפעיל את האפליקציה. |
VersionFilter
אם נדרשות גרסאות ספציפיות של האפליקציה, צריך לכלול את VersionFilter.
ייצוג JSON | |
---|---|
{ "minVersion": number, "maxVersion": number } |
שדות | |
---|---|
minVersion |
קוד גרסה מינימלי או 0, כולל. |
maxVersion |
קוד גרסה מקסימלי, כולל. הטווח החישוב הוא [minVersion:maxVersion]. טווח null מציין כל גרסה. דוגמאות: כדי לציין גרסה יחידה, צריך להשתמש בפורמט: [target_version:target_version]. כדי לציין גרסה כלשהי, צריך להשאיר את minVersion ו-maxVersion לא צוינו. כדי לציין את כל הגרסאות עד maxVersion, צריך להשאיר את minVersion ללא ציון. כדי לציין את כל הגרסאות מ-minVersion, צריך להשאיר את MaxVersion ללא ציון. |
UrlTypeHint
סוגים שונים של רמזים לכתובות URL.
טיפוסים בני מנייה (enum) | |
---|---|
URL_TYPE_HINT_UNSPECIFIED |
לא צוין |
AMP_CONTENT |
כתובת URL שמפנה ישירות לתוכן AMP, או לכתובת URL קנונית שמפנה לתוכן AMP דרך <link rel="amphtml"> . |
ActionMetadata
מטא-נתונים קשורים לכל פעולה.
ייצוג JSON | |
---|---|
{ "expireTime": string } |
שדות | |
---|---|
expireTime |
השעה שבה יפוג תוקף הפעולה. חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: |
גילוי נאות
גילוי נאות לגבי מוצר, שירות או מדיניות שעשוי להיות מוצג למשתמש.
ייצוג JSON | |
---|---|
{ "title": string, "disclosureText": { object ( |
שדות | |
---|---|
title |
הכותרת של הודעת הגילוי הנאות. דוגמה: 'מידע על בטיחות'. |
disclosureText |
התוכן של הגילוי הנאות. מותר להשתמש בקישורי אינטרנט. |
presentationOptions |
אפשרויות הצגה של הגילוי הנאות. |
DisclosureText
מייצג טקסט פשוט עם קישורים לאינטרנט.
ייצוג JSON | |
---|---|
{
"template": string,
"textLinks": [
{
object ( |
שדות | |
---|---|
template |
טקסט להצגה, שמכיל ערכי placeholder כמו "{0}" וגם '{1}' לכל קישור טקסט שצריך להוסיף. דוגמה: "אזהרה: המוצר הזה עלול לחשוף אתכם לכימיקלים שידועים למדינת קליפורניה כגורמים לסרטן. מידע נוסף זמין בכתובת {0}." אין לכלול בטקסט הגילוי הנאות תוכן שיווקי או תוכן דמוי מודעה. |
textLinks[] |
קישורי טקסט שצריך להחליף בתבנית. הראשון יוחלף ב-"{0}" במחרוזת התבנית, והשנייה עבור "{1}" וכו'. |
TextLink
קישור טקסט שצריך להחליף בתבנית.
ייצוג JSON | |
---|---|
{ "displayText": string, "url": string } |
שדות | |
---|---|
displayText |
טקסט שאמור להיות מוצג למשתמשים. |
url |
כתובת ה-URL שאליה המשתמשים יופנו כשהקישור מופעל. |
DisclosurePresentationOptions
אפשרויות להצגת הודעת גילוי נאות.
ייצוג JSON | |
---|---|
{
"presentationRequirement": enum ( |
שדות | |
---|---|
presentationRequirement |
הדרישה להציג את הגילוי הנאות. |
initiallyExpanded |
האם התוכן של הודעת הגילוי הנאות צריך להיות מורחב בהתחלה. כברירת מחדל, הוא מכווץ. |
PresentationRequirement
דרישה להצגת הגילוי הנאות.
טיפוסים בני מנייה (enum) | |
---|---|
REQUIREMENT_UNSPECIFIED |
דרישה לא מוגדרת. אין להגדיר זאת במפורש. |
REQUIREMENT_OPTIONAL |
הגילוי הנאות הוא אופציונלי. אפשר לדלג על השלב הזה אם המכשיר לא תומך בהצגת גילוי נאות. |
REQUIREMENT_REQUIRED |
חובה לכלול את הגילוי הנאות. אם המכשיר לא תומך בהצגת גילוי נאות, השיחה תצורף לשיחה. |
PurchaseItemExtension
תוכן הפריט בקטגוריה 'רכישה'.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
חובה: סטטוס ברמת הפריט. |
userVisibleStatusLabel |
חובה: תווית/מחרוזת הגלויים למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים. |
type |
חובה: סוג הרכישה. |
productId |
מזהה המוצר או המבצע שמשויך לפריט הזה. |
quantity |
כמות היחידות של הפריט. |
unitMeasure |
מידת יחידה. מציינת את גודל הפריט ביחידות שנבחרו. המחיר ליחידה נקבע לפי המידה, יחד עם המחיר הפעיל. |
returnsInfo |
מידע על החזרת מוצרים עבור הפריט הזה. אם המדיניות לא מוגדרת, הפריט הזה יורש מידע על החזרת מוצרים ברמת ההזמנה. |
fulfillmentInfo |
מידע על אספקה של הפריט הזה. אם המדיניות לא מוגדרת, הפריט הזה יורש את פרטי האספקה ברמת ההזמנה. |
itemOptions[] |
תוספים או פריטי משנה נוספים. |
extension |
כל שדה מיותר שהוחלף בין המוכר ל-Google. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
productDetails |
פרטים על המוצר. |
PurchaseStatus
סטטוס רכישה שמשויך להזמנת רכש או לפריט מסוים.
טיפוסים בני מנייה (enum) | |
---|---|
PURCHASE_STATUS_UNSPECIFIED |
הסטטוס לא צוין. |
READY_FOR_PICKUP |
מוכן לאיסוף. |
SHIPPED |
המכשיר נשלח. |
DELIVERED |
ההודעה נמסרה. |
OUT_OF_STOCK |
חסר במלאי. |
IN_PREPARATION |
'IN_PREPARATION' יכולות להיות להם משמעויות שונות בהקשר שונה. אם מדובר בהזמנת מזון, יכול להיות שמדובר בהכנה של אוכל. בקמעונאות, יכול להיות שמדובר בפריט ארוז. |
CREATED |
ההזמנה נוצרה. |
CONFIRMED |
המוכר אישר את ההזמנה. |
REJECTED |
המוכר דחה את ההזמנה או את הפריט. |
RETURNED |
הפריט הוחזר על ידי המשתמש. |
CANCELLED |
המשתמש ביטל את ההזמנה או הפריט. |
CHANGE_REQUESTED |
המשתמש ביקש לשנות את ההזמנה, והמטמיע מעבד את השינוי הזה. אחרי הטיפול בבקשה, יש להעביר את ההזמנה למצב אחר. |
PurchaseType
קטגוריית הרכישה.
טיפוסים בני מנייה (enum) | |
---|---|
PURCHASE_TYPE_UNSPECIFIED |
ערך לא ידוע. |
RETAIL |
הוא כולל רכישות כמו מוצרים פיזיים. |
FOOD |
היא כוללת רכישה של הזמנת אוכל. |
GROCERY |
רכישה של מוצרי מכולת. |
MOBILE_RECHARGE |
רכישת טעינת כסף בנייד בתשלום מראש. |
MerchantUnitMeasure
מידת תמחור יחידה של המוכר.
ייצוג JSON | |
---|---|
{
"measure": number,
"unit": enum ( |
שדות | |
---|---|
measure |
ערך: דוגמה 1.2. |
unit |
Unit: POUND, GRAM |
יחידה
טיפוסים בני מנייה (enum) | |
---|---|
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 'Zulu' , מדויק לננו-שניות. דוגמה: |
price |
העלות של האפשרות הזו. |
fulfillmentContact |
איש הקשר של המשתמש למילוי ההזמנות. |
shippingMethodName |
שם שיטת המשלוח שנבחרה על ידי המשתמש. |
storeCode |
קוד החנות של המיקום. דוגמה: Walmart הוא המוכר, ו-storeCode הוא החנות ב-Walmart שבה בוצע מילוי ההזמנה. https://support.google.com/business/answer/3370250?ref_topic=4596653. |
pickupInfo |
מידע נוסף על אופן הבחירה של ההזמנה. השדה הזה רלוונטי רק אם סוג מילוי ההזמנה הוא PICKUP. |
סוג
סוג האספקה.
טיפוסים בני מנייה (enum) | |
---|---|
TYPE_UNSPECIFIED |
סוג לא צוין. |
DELIVERY |
ההזמנה הזו תימסר. |
PICKUP |
צריך לאסוף את ההזמנה הזו. |
שעה
מבנה זמן שמייצג את הזמן של האירוע שבו צריך להשתמש בהצגת הזמנה למשתמש.
ייצוג JSON | |
---|---|
{ "timeIso8601": string } |
שדות | |
---|---|
timeIso8601 |
מייצג את המועד של אירוע ההזמנה, כמו זמן ההזמנה, זמן האספקה וכן הלאה. הערך יכול להיות משך זמן (שעת התחלה וסיום), תאריך, תאריך ושעה וכו'. מידע נוסף זמין בכתובת https://en.wikipedia.org/wiki/ISO_8601 כדי לראות את כל הפורמטים הנתמכים. |
PickupInfo
פרטים על אופן האיסוף של ההזמנה. הוא כולל פרטים כמו סוג האיסוף ומטא-נתונים נוספים שמצורפים לכל סוג, אם יש.
ייצוג JSON | |
---|---|
{ "pickupType": enum ( |
שדות | |
---|---|
pickupType |
שיטת איסוף, כמו INSTORE, CURBSIDE וכו'. |
curbsideInfo |
פרטים ספציפיים למידע על מדלת העסק. אם הערך שלpickupType הוא לא CURBSIDE, המערכת תתעלם מהשדה הזה. |
checkInInfo[] |
רשימת שיטות שונות שבהן השותף תומך בצ'ק-אין. |
PickupType
רשימה של סוגי האיסוף הנתמכים.
טיפוסים בני מנייה (enum) | |
---|---|
UNSPECIFIED |
לא צוין סוג האיסוף. |
INSTORE |
יש לאסוף אוכל מתוך המסעדה. |
CURBSIDE |
חנה את הרכב במקום ייעודי מחוץ למסעדה, ומישהו היה שולח שם אוכל. |
CurbsideInfo
פרטים על הדרכים שבהן נוכל לסייע בהזמנה מדלת העסק.
ייצוג JSON | |
---|---|
{ "curbsideFulfillmentType": enum ( |
שדות | |
---|---|
curbsideFulfillmentType |
שותפים צריכים מידע נוסף כדי לאפשר הזמנות באיסוף מדלת העסק. בהתאם לסוג מילוי ההזמנות שנבחר, ייאספו פרטים מתאימים מהמשתמש. |
userVehicle |
פרטי הרכב של המשתמש שמבצע את ההזמנה. |
CurbsideFulfillmentType
ערכים אפשריים של סוגי מילוי הזמנות מדלת העסק.
טיפוסים בני מנייה (enum) | |
---|---|
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
שיטות שונות המשמשות לשליחת הוראות צ'ק-אין.
טיפוסים בני מנייה (enum) | |
---|---|
CHECK_IN_TYPE_UNSPECIFIED |
ערך לא ידוע. |
EMAIL |
פרטי הצ'ק-אין יישלחו באימייל. |
SMS |
פרטי צ'ק-אין יישלחו ב-SMS. |
ItemOption
מייצג תוספים או פריטי משנה.
ייצוג JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
שדות | |
---|---|
id |
לאפשרויות שהן פריטים, צריך לציין מזהה פריט ייחודי. |
name |
שם האפשרות. |
prices[] |
המחיר הכולל של האפשרות. |
note |
הערה שקשורה לאפשרות. |
quantity |
לאפשרויות שהן פריטים, כמות. |
productId |
מזהה המוצר או המבצע שמשויך לאפשרות הזו. |
subOptions[] |
כדי להגדיר אפשרויות משנה אחרות בתצוגת עץ. |
ProductDetails
פרטים על המוצר.
ייצוג JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
שדות | |
---|---|
productId |
מזהה המוצר או המבצע שמשויך לפריט הזה. |
gtin |
מספר הפריט המסחרי הגלובלי של המוצר. שימושי אם מזהה המבצע לא קיים ב-Merchant Center. זה שינוי אופציונלי. |
plu |
קודים לחיפוש מחירים, שנקראים בדרך כלל קודי PLU, מספרי PLU, רכיבי PLU, קודי מוצרים או תוויות של ייצור, הם מערכת מספרים שמזהים באופן ייחודי מוצרים בכמות גדולה שנמכרים בחנויות מכולת ובסופרמרקט. |
productType |
קטגוריית המוצר שהוגדרה על ידי המוֹכר. לדוגמה "דף הבית > מכולת > מוצרי חלב ביצים > חלב > חלב מלא" |
productAttributes |
פרטים שהמוכר סיפק לגבי המוצר, למשל: { "allergen": "peanut" }. שימושי אם מזהה המבצע לא קיים ב-Merchant Center. זה שינוי אופציונלי. אובייקט שמכיל רשימה של |
ReservationItemExtension
תוכן הפריט בהזמנות כמו מסעדה, תספורת וכו'. המזהה הבא: 15.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
חובה: סטטוס הזמנה. |
userVisibleStatusLabel |
חובה: תווית/מחרוזת הגלויים למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים. |
type |
סוג ההזמנה. אם אף אחת מאפשרויות הסוג לא רלוונטית, יכול להיות שההגדרה לא תהיה רלוונטית. |
reservationTime |
השעה שבה השירות/האירוע מתוזמן להתרחש. אפשר להגדיר טווח זמן, תאריך או תאריך מדויק. |
userAcceptableTimeRange |
טווח הזמן המקובל על המשתמש. |
confirmationCode |
קוד האישור של ההזמנה הזו. |
partySize |
מספר האנשים. |
staffFacilitators[] |
משתמשים עם הרשאות אדמין לצוות הניהול של ההזמנה. דוגמה: מעצב השיער. |
location |
מיקום השירות או האירוע. |
extension |
כל שדה מיותר שהוחלף בין המוכר ל-Google. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
ReservationStatus
סטטוס ההזמנה.
טיפוסים בני מנייה (enum) | |
---|---|
RESERVATION_STATUS_UNSPECIFIED |
הסטטוס לא צוין. |
PENDING |
ההזמנה בהמתנה. |
CONFIRMED |
ההזמנה אושרה. |
CANCELLED |
ההזמנה בוטלה על ידי המשתמש. |
FULFILLED |
ההזמנה בוצעה. |
CHANGE_REQUESTED |
נשלחה בקשה לשינוי ההזמנה |
REJECTED |
פג התוקף של ההזמנה או שהיא נדחתה על ידי מבצע השילוב. |
ReservationType
סוג ההזמנה.
טיפוסים בני מנייה (enum) | |
---|---|
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 וגם ב-Merchant. |
PaymentMethodDisplayInfo
תוצאת התשלום שמשמשת את מבצע השילוב להשלמת עסקה.
ייצוג JSON | |
---|---|
{
"paymentType": enum ( |
שדות | |
---|---|
paymentType |
סוג התשלום. |
paymentMethodDisplayName |
השם הגלוי למשתמש של אמצעי התשלום. לדוגמה, VISA **** 1234 בדיקה חשבון **** 5678 |
paymentMethodVoiceName |
שם אמצעי התשלום שיושמע למשתמש במכשירים עם Assistant מובנית. לדוגמה, "ויזה שמסתיימת באחת שתיים שלוש ארבע" או "חשבון עובר וש המסתיים בספרות חמש ושמונה ושמונה". הערה: זוהי מחרוזת מותאמת לקול לשימוש במקום paymentMethodDisplayName עבור מכשירים עם Assistant קולית. אם המחרוזת הזו לא מוגדרת, המשתמש אמור להקריא את paymentMethodDisplayName. |
PaymentType
PaymentType מציין את אמצעי התשלום שבו נעשה שימוש באמצעי התשלום שסופק על ידי המוכר. הפעולה צריכה לכלול גם את השם המוצג של אמצעי התשלום.
טיפוסים בני מנייה (enum) | |
---|---|
PAYMENT_TYPE_UNSPECIFIED |
לא צוין סוג תשלום. |
PAYMENT_CARD |
כרטיס אשראי, כרטיס חיוב מיידי או כרטיס תשלום מראש. |
BANK |
אמצעי התשלום הוא חשבון בנק. |
LOYALTY_PROGRAM |
אמצעי התשלום הוא מועדון לקוחות. |
CASH |
אמצעי התשלום במזומן. |
GIFT_CARD |
אמצעי התשלום הוא כרטיס מתנה. |
WALLET |
ארנק של צד שלישי, כמו PayPal |
PaymentMethodProvenance
מייצג את מקור אמצעי התשלום ששימש לעסקה.
טיפוסים בני מנייה (enum) | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED |
לא צוינה מקור. |
PAYMENT_METHOD_PROVENANCE_GOOGLE |
המקור הוא Google. |
PAYMENT_METHOD_PROVENANCE_MERCHANT |
המקור הוא Merchant. |
קידום מכירות
מבצעים או מבצעים שנוספו לעגלת הקניות.
ייצוג JSON | |
---|---|
{ "coupon": string } |
שדות | |
---|---|
coupon |
נדרש: קוד השובר שהוחל על המבצע הזה. |
PurchaseOrderExtension
תוסף הזמנה עבור קטגוריית הרכישה. המאפיינים האלה רלוונטיים לכל הפריטים בתוך ההזמנה, אלא אם הם בוטלו בפריט מסוים.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
חובה: הסטטוס הכללי של ההזמנה. |
userVisibleStatusLabel |
תווית/מחרוזת גלויה למשתמש עבור הסטטוס. האורך המקסימלי המותר הוא 50 תווים. |
type |
חובה: סוג הרכישה. |
returnsInfo |
פרטי ההחזרה של ההזמנה. |
fulfillmentInfo |
מידע על אספקה של ההזמנה. |
extension |
כל שדה מיותר שהוחלף בין המוכר ל-Google. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
purchaseLocationType |
מיקום הרכישה (בחנות או באינטרנט) |
errors[] |
אופציונלי: שגיאות שבגללן ההזמנה הזו נדחתה. |
PurchaseLocationType
סוג מיקום הרכישה.
טיפוסים בני מנייה (enum) | |
---|---|
UNSPECIFIED_LOCATION |
ערך לא ידוע. |
ONLINE_PURCHASE |
כל הרכישות נקנו באינטרנט. |
INSTORE_PURCHASE |
כל הרכישות בחנות. |
PurchaseError
שגיאות שעבורן אפשר לדחות הזמנת רכש.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
חובה: מייצג את הסיבה המפורטת לכך שהמוכר דחה הזמנה. |
description |
תיאור שגיאה נוסף. |
entityId |
מזהה הישות שתואם לשגיאה. דוגמה לכך יכולה להתאים ל-LineItemId / ItemOptionId. |
updatedPrice |
רלוונטי במקרה של סוג השגיאה PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
כמות זמינה עכשיו. רלוונטי במקרה של AVAILABILITY_CHANGED. |
ErrorType
סוגי שגיאות אפשריים.
טיפוסים בני מנייה (enum) | |
---|---|
ERROR_TYPE_UNSPECIFIED |
שגיאה לא ידועה |
NOT_FOUND |
הישות לא נמצאה, יכול להיות: 'פריט', 'FulfillmentOption', 'קידום מכירות'. נדרש מזהה ישות. |
INVALID |
נתוני הישות לא תקינים. הערך יכול להיות Item, FulfillmentOption, Promotion. נדרש מזהה ישות. |
AVAILABILITY_CHANGED |
הפריט לא זמין או שאין מספיק פריטים למילוי הבקשה. נדרש מזהה ישות. |
PRICE_CHANGED |
מחיר הפריט שונה מהמחיר בישות הפריט. חובה לציין מזהה ישות ומחיר מעודכן. |
INCORRECT_PRICE |
שגיאות מחירים ב'עמלות', 'סה"כ'. חובה לציין מזהה ישות ומחיר מעודכן. |
REQUIREMENTS_NOT_MET |
המגבלות על קבלת ההזמנה לא עומדות במגבלות – גודל סל הקניות המינימלי וכו'. |
TOO_LATE |
פג התוקף של FulfillmentOption. |
NO_CAPACITY |
אין קיבולת שירות זמינה. |
INELIGIBLE |
המשתמש לא כשיר לבצע את ההזמנה (רשימה שחורה). |
OUT_OF_SERVICE_AREA |
לא ניתן לשלוח לכתובת המבוקשת בגלל כללי גבול וכו'. |
CLOSED |
המסעדה סגורה בשעת ההזמנה. |
PROMO_NOT_APPLICABLE |
קוד שגיאה גנרי שמתייחס לכל המקרים של כשל במימוש קוד ההטבה, אם אף אחד מהם לא מתאים. הוספת קוד ההטבה כמזהה ישות ב-SAML. |
PROMO_NOT_RECOGNIZED |
קוד השובר לא זוהה על ידי השותף. הוספת קוד ההטבה כמזהה ישות ב-SAML. |
PROMO_EXPIRED |
לא ניתן להחיל את המבצע כי פג התוקף שלו. הוספת קוד ההטבה כמזהה ישות ב-SAML. |
PROMO_USER_INELIGIBLE |
המשתמש הנוכחי אינו זכאי לשובר הזה. הוספת קוד ההטבה כמזהה ישות ב-SAML. |
PROMO_ORDER_INELIGIBLE |
ההזמנה הנוכחית לא עומדת בדרישות לקבלת השובר הזה. הוספת קוד ההטבה כמזהה ישות ב-SAML. |
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. |
סוג
סוג האירוע.
טיפוסים בני מנייה (enum) | |
---|---|
EVENT_TYPE_UNKNOWN |
סוג אירוע לא ידוע. |
MOVIE |
סרט. |
CONCERT |
קונצרט. |
SPORTS |
ספורט. |
EventCharacter
תו אירוע אחד, למשל מארגן, מבצע וכו'.
ייצוג JSON | |
---|---|
{ "type": enum ( |
שדות | |
---|---|
type |
סוג תו האירוע, למשל שחקן או במאי. |
name |
שם הדמות. |
image |
התמונות של הדמות. |
סוג
סוג התו.
טיפוסים בני מנייה (enum) | |
---|---|
TYPE_UNKNOWN |
סוג לא ידוע. |
ACTOR |
המשתמש. |
PERFORMER |
אמנים. |
DIRECTOR |
במאי. |
ORGANIZER |
מארגן. |