- ייצוג JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- Date (תאריך)
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- כסף
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
כתובת URL של פעולה עם שפה משויכת, רשימת מדינות מוגבלות ופלטפורמה אופציונלית, שמציינת באיזו פלטפורמה צריך לבצע את הפעולה הזו.
ייצוג JSON |
---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
שדות | |
---|---|
url |
כתובת ה-URL של נקודת הכניסה לקישור לפעולה הזו. |
language |
תג השפה BCP-47 שמזהה את השפה שבה זמין התוכן מה-URI הזה. |
restrictedCountry[] |
קוד מדינה לפי תקן ISO 3166-1 alpha-2. צריך להשאיר את השדה ריק כדי לאפשר חשיפה בלתי מוגבלת. |
platform |
הפלטפורמה שבה צריך לבצע את הפעולה הזו. אם השדה הזה לא מוגדר, המערכת תשתמש ב-ACTION_PLATFORM_WEB_APPLICATION כחלופה. |
actionLinkType |
סוג הפעולה שנקבע מראש. |
orderOnlineMetadata |
מטא-נתונים של הקישור להזמנה אונליין. תומכת בפעולה עם ActionLinkType של ACTION_LINK_TYPE_SHOP_Online. |
foodOrderingMetadata |
מטא-נתונים של קישורים להזמנות ממסעדות. תומכת בסוג הפעולה: * |
ActionPlatform
הפלטפורמה שבה מתבצעת הפעולה. אפליקציית אינטרנט היא החלופה הכללית. מומלץ להגדיר לפחות ActionLink אחד עם ACTION_PLATFORM_WEB_APPLICATION. קישורים ל-Android ול-iOS כפלטפורמה משמשים רק במערכת המתאימה.
טיפוסים בני מנייה (enum) | |
---|---|
ACTION_PLATFORM_UNSPECIFIED |
הפלטפורמה לא צוינה. |
ACTION_PLATFORM_WEB_APPLICATION |
פלטפורמת הפעולה היא באופן כללי באינטרנט. |
ACTION_PLATFORM_MOBILE_WEB |
פלטפורמת הפעולה היא אינטרנט במכשירים ניידים. |
ACTION_PLATFORM_ANDROID |
פלטפורמת הפעולה היא Android OS. |
ACTION_PLATFORM_IOS |
פלטפורמת הפעולות היא iOS. |
ActionLinkType
סוג פעולה שנקבע מראש ומשויך לקישור לפעולה.
טיפוסים בני מנייה (enum) | |
---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
לא צוין סוג הקישור לפעולה. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
סוג הקישור לפעולה הוא קביעת פגישה. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
הקישור לפעולה הוא קביעת פגישה אונליין. |
ACTION_LINK_TYPE_ORDER_FOOD |
סוג הקישור לפעולה הוא הזמנת אוכל במשלוח, באיסוף עצמי או בשניהם. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
סוג הקישור לפעולה הוא הזמנת אוכל למשלוח. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
סוג הקישור לפעולה הוא הזמנת אוכל לטייק אוויי. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
סוג הקישור לפעולה הוא הזמנת מקום במסעדה. |
ACTION_LINK_TYPE_SHOP_ONLINE |
סוג הקישור לפעולה הוא הזמנה לקניות, יכול להיות משלוח, איסוף או גם וגם. |
OrderOnlineMetadata
מטא-נתונים של קישור לפעולה אונליין של הזמנה.
ייצוג JSON |
---|
{
"fulfillmentOption": [
{
object ( |
שדות | |
---|---|
fulfillmentOption[] |
אפשרויות זמינות למילוי הזמנות עבור קישור לפעולה אונליין של הזמנה. |
FulfillmentOption
אפשרות מילוי ההזמנה של קישור לפעולה אונליין.
ייצוג JSON |
---|
{ "fulfillmentType": enum ( |
שדות | |
---|---|
fulfillmentType |
חובה. סוג האספקה. |
availableDay[] |
חובה. רשימת ימים שבהם יש זמינות לשיטת מילוי ההזמנות הזו (עדיף 2 לפחות). |
feeDetails |
חובה. פרטי העמלות של שיטת מילוי ההזמנות. |
minimumOrder |
חובה. הזמנה מינימלית לשיטת מילוי ההזמנות שמשויכת לקישור הפעולה. |
FulfillmentType
סוג מילוי ההזמנות שמשויך לקישור לפעולה.
טיפוסים בני מנייה (enum) | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
לא צוין סוג מילוי ההזמנות. |
FULFILLMENT_TYPE_DELIVERY |
סוג האספקה הוא מסירה. |
FULFILLMENT_TYPE_PICKUP |
סוג מילוי ההזמנה הוא איסוף. |
AvailableDay
זמינות ברמת היום.
ייצוג JSON |
---|
{
"fulfillmentDate": {
object ( |
שדות | |
---|---|
fulfillmentDate |
חובה. תאריך זמין לשיטת מילוי ההזמנה. ההנחה היא באזור הזמן של המוכר. |
lastOrderingTime |
חובה. חותמת זמן של Unix. הפעם האחרונה שבה משתמש יכול להזמין ולקבל פריטים עד לדוגמה, אם תאריך מילוי ההזמנה הוא 2020-08-10: – הערך של lastOrderTime הוא 18:00-2020-08-10. פירוש הדבר הוא שכדי לקבל את ההזמנה ב-10 באוגוסט 2020, הלקוח צריך לבצע את ההזמנה עד השעה 18:00 באותו יום. - המשמעות של הערך lastOrderTime (2020-08-08) 20:00 היא שכדי לקבל את ההזמנה ב-10 באוגוסט 2020, הלקוח צריך לבצע את ההזמנה עד השעה 20:00 יומיים לפני כן. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
תאריך
מייצג תאריך קלנדרי מלא או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. המצב הזה יכול לייצג אחת מהאפשרויות הבאות:
- תאריך מלא, עם ערכים שונים של שנה, חודש ויום.
- חודש ויום, עם שנה אפס (למשל יום נישואין).
- שנה בפני עצמה, עם חודש אפס ויום אפס.
- שנה וחודש, עם יום אפס (לדוגמה, תאריך תפוגה של כרטיס אשראי).
סוגים קשורים:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
ייצוג JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
שדות | |
---|---|
year |
השנה שבה חל התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה. |
month |
החודש בשנה. הערך חייב להיות 1 עד 12, או 0 כדי לציין שנה בלי חודש ויום. |
day |
היום בחודש. הערך צריך להיות בין 1 ל-31 ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם אין חשיבות לציון יום מסוים. |
FeeDetails
פרטי העמלות של שיטת מילוי ההזמנות שמשויכת לקישור הפעולה.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד fee_details . מודל עמלה של שיטת מילוי ההזמנות. fee_details יכול להיות רק אחת מהאפשרויות הבאות: |
|
noFee |
אין עמלה על שיטת מילוי ההזמנה. |
baseFee |
העמלה הבסיסית שמשויכת לשיטת מילוי ההזמנות. |
fixedFee |
העמלה הקבועה שמשויכת לשיטת מילוי ההזמנות. |
NoFee
לא נדרשת עמלה על שיטת מילוי ההזמנות שמשויכת לקישור הפעולה.
MinimumFee
העמלה המינימלית הנדרשת לשיטת מילוי ההזמנות שמשויכת לקישור הפעולה.
ייצוג JSON |
---|
{
"baseFeeAmount": {
object ( |
שדות | |
---|---|
baseFeeAmount |
חובה. סכום העמלה הבסיסית לשיטת מילוי ההזמנות. |
FixedFee
העמלה הקבועה שנדרשת לשיטת מילוי ההזמנות שמשויכת לקישור הפעולה.
ייצוג JSON |
---|
{
"amount": {
object ( |
שדות | |
---|---|
amount |
חובה. סכום העמלה הקבועה של שיטת מילוי ההזמנה. |
FoodOrderingMetadata
מטא-נתונים של קישורים לפעולות להזמנת אוכל.
ייצוג JSON |
---|
{ "feeDetails": [ { object ( |
שדות | |
---|---|
feeDetails[] |
פרטי העמלות שבהן המשתמש חויב, בנוסף לסכום הכולל של הפריט. חוזרים על התהליך לגבי סוגים שונים של עמלות, כמו עמלת שירות, דמי משלוח וכו'. |
advanceOrderDetails |
פרטים על תמיכה מתקדמת בהזמנה, שנקראת גם 'הזמנה מראש', שמאפשרת למשתמש לבצע הזמנה במועד מאוחר יותר מאשר עכשיו. |
שדה איחוד fulfillment_duration_options . משך זמן האספקה של ההזמנה מאישור ההזמנה. בהזמנות עם משלוח, משך הזמן עד למסירת האוכל. בהזמנות באיסוף עצמי, יש לציין את משך הזמן עד שהאוכל יהיה מוכן לאיסוף. fulfillment_duration_options יכול להיות רק אחת מהאפשרויות הבאות: |
|
fulfillmentLeadTimeDuration |
משך זמן קבוע. לדוגמה: 30 דקות. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
fulfillmentLeadTimeDurationRange |
טווח זמן. דוגמאות: * 30 דקות עד 45 דקות * יותר מ-30 דקות * פחות מ-50 דקות |
FeeDetails
פרטי העמלות.
ייצוג JSON |
---|
{ "type": enum ( |
שדות | |
---|---|
type |
סוג העמלה. (חובה) |
feeAmount |
סכום העמלה במטבע של היחידה, באחוז מערך עגלת הקניות או בשילוב של שניהם. (חובה) |
FeeType
סוג העמלה.
טיפוסים בני מנייה (enum) | |
---|---|
FEE_TYPE_UNSPECIFIED |
לא צוין סוג העמלה. |
DELIVERY |
לגבי דמי משלוח. |
SERVICE |
עמלות שירות. |
FeeAmount
FeeAmount
דוגמאות: * עמלה קבועה: USD 0 (ללא עמלה), USD 1.5 * טווח עמלה קבועה: USD 1.0 (מינימום), USD 3.0 (מקסימום), USD 5.0-6.0 * אחוז גודל עגלת הקניות: 15.5%, 10%-20%, 10% (מינימום), 15% (מקסימום) * מורכב מהטווח ומ-2%: USD 2.5 (מינימום), 25.5% ו- 4.5 דולר ארה"ב (מקסימום), 10% ו- USD 1.5-2.5, 10.5%-20% & USD 2.5-3.5
ייצוג JSON |
---|
{ "cartPercentage": { object ( |
שדות | |
---|---|
cartPercentage |
העמלה במונחים של אחוז מערך עגלת הקניות. תומכת בטווח (מוגבל ולא מוגבל) או באחוז קבוע. הערך צריך להיות בין 0 ל-100. דוגמאות: * קבוע 5.5% * 5.5% לפחות * 5.5% * 4.5% עד 5.5% |
שדה איחוד amount_options . אפשרויות לציון סכום כספי. amount_options יכול להיות רק אחת מהאפשרויות הבאות: |
|
amount |
סכום קבוע. למשל, USD 3.5. |
amountRange |
טווח הסכום. דוגמאות: * 3.5 USD עד USD 5.5 * לפחות USD 3.5 * לכל היותר 5.5 USD |
amountUnknown |
סכום לא ידוע. |
כסף
מייצג סכום כסף בסוג המטבע שלו.
ייצוג JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currencyCode |
קוד המטבע בן שלוש האותיות כפי שמוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ל- +999,999,999, כולל. אם הערך של |
MoneyRange
Wrapper לטווח של סכומים כספיים שאפשר להגדיר להם גבולות או הגבלות. צריך לציין לפחות אחד מהשדות minAmount ו-maxAmount.
ייצוג JSON |
---|
{ "minAmount": { object ( |
שדות | |
---|---|
minAmount |
סכום מינימלי. |
maxAmount |
סכום מקסימלי. |
QuantitativeValue
wrapper של ערך מספרי שיכול להיות טווח או ערך קבוע. QuantitativeValue
דוגמאות: * ערך יחיד: value: 10.5
* טווח תחום: valueRange {minValue: 5.5, maxValue 10.5}
* גבול תחתון: valueRange {minValue: 5.5}
* גבול עליון: valueRange {maxValue: 10.5}
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד value_options . (חובה) המאפיין value_options יכול להיות רק אחת מהאפשרויות הבאות: |
|
value |
ערך יחיד. לדוגמה: 5.6 |
valueRange |
טווח של ערכים שיכולים להיות עם סיום פתוח או מוגבל. דוגמאות: * לפחות 5.5 * 5.5 * 5.5 עד 6.5 |
RangeValue
טווח ערכים כמו minValue
< maxValue
. נדרש לפחות אחד מהערכים minValue
ו-maxValue
.
ייצוג JSON |
---|
{ "minValue": number, "maxValue": number } |
שדות | |
---|---|
minValue |
ערך מינימלי. |
maxValue |
ערך מקסימלי. |
DurationRange
תוכנת wrapper למשך טווח זמן שאי אפשר לתחום או לתחום. צריך להגדיר לפחות משך זמן אחד מסוג minDuration (משך זמן מקסימלי) ו-maxDuration (משך זמן מקסימלי).
ייצוג JSON |
---|
{ "minDuration": string, "maxDuration": string } |
שדות | |
---|---|
minDuration |
משך זמן מינימלי. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
maxDuration |
משך זמן מקסימלי. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
AdvanceOrderDetails
לתמיכה בנושא הזמנה מראש.
ייצוג JSON |
---|
{ "isSupported": boolean } |
שדות | |
---|---|
isSupported |
הערך הוא True אם יש תמיכה בהזמנות מראש, שנקראת גם 'הזמנה מראש'. (חובה) |