Order

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

string

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

string

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

string

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

string

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

object (PhoneNumber)

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

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

string

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

string

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

string

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

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

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

string

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

string

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

number

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

number

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

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

string

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

string

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

object (Image)

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

object (PhoneNumber)

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

object (Location)

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

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

object (LatLng)

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

string

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

string

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

string

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

object (PostalAddress)

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

string

שם המקום.

string

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

string

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

string

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

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

number

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

number

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

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

number

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

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

string

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

string

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

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

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

string

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

string

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

string

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

string

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

string

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

string

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

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

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

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

string

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

string

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

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

object (LineItem)

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

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

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

string

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

string

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

string

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

object (Merchant)

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

object (PriceAttribute)

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

object (Action)

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

object (UserInfo)

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

object (Image)

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

string

תיאור הפריט.

string

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

object (Disclosure)

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

object

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

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

object (PurchaseItemExtension)

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

object (ReservationItemExtension)

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

{
  "type": enum (Type),
  "name": string,
  "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.
}

enum (Type)

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

string

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

enum (State)

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

boolean

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

object (Money)

סכום כספי.

number

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

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

string

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

string (int64 format)

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

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

enum (Type)

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

string

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

object (OpenUrlAction)

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

object (ActionMetadata)

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

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

string

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

object (AndroidApp)

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

enum (UrlTypeHint)

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

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

string

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

object (VersionFilter)

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

{
  "minVersion": number,
  "maxVersion": number
}

number

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

number

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

{
  "expireTime": string
}

string (Timestamp format)

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

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

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

string

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

object (DisclosureText)

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

object (DisclosurePresentationOptions)

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

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

string

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

object (TextLink)

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

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

string

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

string

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

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

enum (PresentationRequirement)

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

boolean

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

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

enum (PurchaseStatus)

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

string

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

enum (PurchaseType)

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

string

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

number

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

object (MerchantUnitMeasure)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object (ItemOption)

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

object

כל שדה מיותר שהוחלף בין המוכר ל-Google.

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

object (ProductDetails)

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

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

number

ערך: דוגמה 1.2.

enum (Unit)

Unit: POUND, GRAM

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

boolean

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

number

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

string

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

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

string

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

enum (Type)

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

object (Time)

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

object (Time)

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

object (Location)

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

string (Timestamp format)

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

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

object (PriceAttribute)

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

object (UserInfo)

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

string

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

string

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

object (PickupInfo)

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

{
  "timeIso8601": string
}

string

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

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

enum (PickupType)

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

object (CurbsideInfo)

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

object (CheckInInfo)

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

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

enum (CurbsideFulfillmentType)

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

object (Vehicle)

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

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

string

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

string

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

string

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

string

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

object (Image)

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

{
  "checkInType": enum (CheckInType)
}

enum (CheckInType)

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

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

string

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

string

שם האפשרות.

object (PriceAttribute)

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

string

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

number

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

string

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

object (ItemOption)

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

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

string

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

string

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

string

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

string

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

map (key: string, value: string)

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

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

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

enum (ReservationStatus)

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

string

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

enum (ReservationType)

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

object (Time)

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

object (Time)

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

string

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

number

מספר האנשים.

object (StaffFacilitator)

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

object (Location)

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

object

כל שדה מיותר שהוחלף בין המוכר ל-Google.

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

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

string

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

object (Image)

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

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

object (PaymentResult)

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

object (PaymentInfo)

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

{

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

string

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

string

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

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

object (PaymentMethodDisplayInfo)

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

enum (PaymentMethodProvenance)

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

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

enum (PaymentType)

סוג התשלום.

string

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

string

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

{
  "coupon": string
}

string

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

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

enum (PurchaseStatus)

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

string

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

enum (PurchaseType)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object

כל שדה מיותר שהוחלף בין המוכר ל-Google.

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

enum (PurchaseLocationType)

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

object (PurchaseError)

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

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

enum (ErrorType)

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

string

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

string

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

object (PriceAttribute)

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

number

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

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

object (TicketEvent)

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

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

enum (Type)

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

string

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

string

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

string

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

object (Location)

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

object (EventCharacter)

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

object (Time)

שעת התחלה.

object (Time)

שעת סיום.

object (Time)

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

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

enum (Type)

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

string

שם הדמות.

object (Image)

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