- ייצוג JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- תאריך
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount (סכום העמלות)
- Money
- 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 רק במערכת המתאימה.
טיפוסים בני מנייה (enums) | |
---|---|
ACTION_PLATFORM_UNSPECIFIED |
הפלטפורמה לא צוינה. |
ACTION_PLATFORM_WEB_APPLICATION |
פלטפורמת הפעולה היא באינטרנט באופן כללי. |
ACTION_PLATFORM_MOBILE_WEB |
פלטפורמת הפעולה היא אינטרנט במכשירים ניידים. |
ACTION_PLATFORM_ANDROID |
פלטפורמת הפעולה היא Android OS. |
ACTION_PLATFORM_IOS |
פלטפורמת הפעולה היא iOS. |
ActionLinkType
סוג הפעולה שמשויך לקישור לפעולה, שנקבע מראש.
טיפוסים בני מנייה (enums) | |
---|---|
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
סוג מילוי הבקשה שמשויך לקישור פעולה.
טיפוסים בני מנייה (enums) | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
לא צוין סוג מילוי הבקשה. |
FULFILLMENT_TYPE_DELIVERY |
סוג האספקה הוא משלוח. |
FULFILLMENT_TYPE_PICKUP |
סוג מילוי ההזמנה הוא איסוף. |
AvailableDay
זמינות ברמת היום.
ייצוג JSON |
---|
{
"fulfillmentDate": {
object ( |
שדות | |
---|---|
fulfillmentDate |
חובה. תאריך פנוי של שיטת מילוי ההזמנה. אזור הזמן אמור להיות לפי אזור הזמן של המוכר. |
lastOrderingTime |
חובה. חותמת זמן של Unix. הפעם האחרונה שמשתמש יכול להזמין ולקבל פריטים עד לדוגמה, אם השדה fulfillmentDate הוא 2020-08-10: ערך אחרון של OrderingTime 18:00-2020-08:00 פירושו שכדי שההזמנה תגיע ב-10 באוגוסט 2020, הלקוח צריך לבצע את ההזמנה עד 18:00 באותו יום. - ערך אחרון להזמנה הוא 20:08-2020. המשמעות היא שכדי לקבל את ההזמנה ב-10.8.2020, הלקוח צריך לבצע את ההזמנה עד 20:00 יומיים לפני. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
תאריך
מייצג תאריך קלנדרי מלא או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שאינם משמעותיים. התאריך הזה יחסי ללוח השנה הגרגוריאני. הנתון הזה יכול לייצג אחת מהאפשרויות הבאות:
- תאריך מלא, עם ערכים שונים של שנה, חודש ויום.
- חודש ויום, עם שנה של אפס (למשל יום נישואין).
- שנה בפני עצמה, עם חודש של אפס ואפס יום.
- שנה וחודש, עם אפס יום (לדוגמה, תאריך תפוגה של כרטיס אשראי).
סוגים קשורים:
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
סוג עמלה.
טיפוסים בני מנייה (enums) | |
---|---|
FEE_TYPE_UNSPECIFIED |
לא צוין סוג העמלה. |
DELIVERY |
דמי משלוח. |
SERVICE |
לגבי עמלות שירות. |
FeeAmount
FeeAmount
דוגמאות: * עמלה קבועה: USD 0 (ללא עמלה), USD 1.5 * טווח עמלה קבועה: 1.0 USD (מינימום), USD 3.0 (מקסימום), USD 5.0-6.0 USD * אחוז מגודל עגלת הקניות: 15.5%, 10%-20%, 10% (מינימום), 15% (מקסימום 5% ו-2.5 USD) (מקסימום 5% ו-2 USD) (מקסימום 5.0.5%) ו-2% USD
ייצוג 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 * 3.5 USD לפחות * 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
ממיר לטווח של סכום כספי שעשוי להיות מוגבל או לא מוגבל. יש לציין לפחות ערך אחד מסוג 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 אם יש תמיכה בתכונה 'הזמנות מראש', שנקראת גם 'הזמנה מראש'. (חובה) |