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

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

buyerInfo

object (UserInfo)

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

image

object (Image)

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

createTime

string (Timestamp format)

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

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

lastUpdateTime

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: "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)

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

מספר טלפון

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

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

string

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

extension

string

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

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

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

מייצג כתובת למשלוח דואר, למשל עבור כתובות למשלוח דואר או תשלומים. אם תספקו כתובת למשלוח דואר, שירות הדואר יכול לשלוח פריטים לעסק שלכם, 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

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, עיר דואר בבריטניה. באזורים בעולם שבהם רשויות מוניציפאליות לא מוגדרות היטב או שלא מתאימות למבנה הזה בצורה טובה, השאירו את הרשות המוניציפאלית ריקה והשתמשו בקווי כתובת.

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

תוכן עניינים

wrapper של פריטים.

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

object (LineItem)

רשימה של פריטי הזמנה. יש להוסיף לפחות 50 שורות ולא יותר מ-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% מיוצג כ-8750, באחוזים שליליים מייצגים הנחות באחוזים. אנחנו מוציאים את השדה הזה משימוש. כדאי להוסיף חזרה כאשר יש צורך בתרחיש לדוגמה מוצק.

סוג

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

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

מדינה

מייצג את מצב המחיר.

טיפוסים בני מנייה (enum)
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)

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

סוג

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

טיפוסים בני מנייה (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 (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
שדות
url

string

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

androidApp

object (AndroidApp)

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

urlTypeHint

enum (UrlTypeHint)

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

AndroidApp

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

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

string

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

versions[]

object (VersionFilter)

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

VersionFilter

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

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

number

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

maxVersion

number

קוד גרסה מקסימלי, כולל. הטווח החישוב הוא [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

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' , מדויק לננו-שניות. דוגמה: "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

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

DisclosurePresentationOptions

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

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

enum (PresentationRequirement)

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

initiallyExpanded

boolean

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

PresentationRequirement

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (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 (Unit)
}
שדות
measure

number

ערך: דוגמה 1.2.

unit

enum (Unit)

Unit: POUND, GRAM

יחידה

טיפוסים בני מנייה (enum)
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 'Zulu' , מדויק לננו-שניות. דוגמה: "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.

סוג

סוג האספקה.

טיפוסים בני מנייה (enum)
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)

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

checkInInfo[]

object (CheckInInfo)

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

PickupType

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

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

CurbsideInfo

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

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

enum (CurbsideFulfillmentType)

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

userVehicle

object (Vehicle)

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

CurbsideFulfillmentType

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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

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

productId

string

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

subOptions[]

object (ItemOption)

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

ProductDetails

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

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

string

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

gtin

string

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

plu

string

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

productType

string

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

productAttributes

map (key: string, value: string)

פרטים שהמוכר סיפק לגבי המוצר, למשל: { &quot;allergen&quot;: &quot;peanut&quot; }. שימושי אם מזהה המבצע לא קיים ב-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

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

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

ReservationType

סוג ההזמנה.

טיפוסים בני מנייה (enum)
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 וגם ב-Merchant.

PaymentMethodDisplayInfo

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

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

enum (PaymentType)

סוג התשלום.

paymentMethodDisplayName

string

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

paymentMethodVoiceName

string

שם אמצעי התשלום שיושמע למשתמש במכשירים עם 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

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

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

טיפוסים בני מנייה (enum)
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_CHANGED / INCORRECT_PRICE.

availableQuantity

number

כמות זמינה עכשיו. רלוונטי במקרה של 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

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.

סוג

סוג האירוע.

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

EventCharacter

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

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

enum (Type)

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

name

string

שם הדמות.

image

object (Image)

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

סוג

סוג התו.

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