- ייצוג ב-JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- Date (תאריך)
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- כסף
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Surface
כתובת URL של פעולה עם השפה המשויכת, רשימת המדינות שבהן הפעולה מוגבלת ופלטפורמה אופציונלית שמציינת באיזו פלטפורמה הפעולה צריכה להתבצע.
ייצוג JSON |
---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
שדות | |
---|---|
url |
כתובת ה-URL של נקודת הכניסה לקישור הפעולה הזה. |
language |
תג השפה BCP-47 שמזהה את השפה שבה התוכן מ-URI הזה זמין. |
restricted |
קוד מדינה בפורמט ISO 3166-1 alpha-2. צריך להשאיר את השדה ריק כדי לאפשר חשיפה בלתי מוגבלת. |
platform |
הפלטפורמה שבה צריך לבצע את הפעולה הזו. אם השדה הזה לא מוגדר, המערכת תשתמש ב-ACTION_PLATFORM_WEB_APPLICATION כחלופה. |
action |
סוג פעולה מוגדר מראש. |
order |
מטא-נתונים של הקישור להזמנות אונליין. תומכת בפעולה עם ActionLinkType של ACTION_LINK_TYPE_SHOP_Online. |
food |
מטא-נתונים של קישורים להזמנות ממסעדות. יש תמיכה בסוג הפעולה: * |
event |
מידע נוסף על קישור הפעולה, שהוא ייחודי לתחום האירועים. |
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 |
סוג הקישור של הפעולה הוא הזמנה ב-Shopping, יכול להיות משלוח או איסוף עצמי או שניהם. |
OrderOnlineMetadata
מטא-נתונים של קישור לפעולה להזמנה אונליין.
ייצוג JSON |
---|
{
"fulfillmentOption": [
{
object ( |
שדות | |
---|---|
fulfillment |
אפשרויות המילוי הזמינות לקישור לביצוע הזמנה אונליין. |
FulfillmentOption
אפשרות מילוי ההזמנה של קישור לפעולה אונליין.
ייצוג ב-JSON |
---|
{ "fulfillmentType": enum ( |
שדות | |
---|---|
fulfillment |
חובה. סוג המילוי. |
available |
חובה. רשימת ימים שבהם יש זמינות לשיטת מילוי ההזמנות הזו (עדיף 2 לפחות). |
fee |
חובה. פרטי העמלות של שיטת מילוי ההזמנות. |
minimum |
חובה. הזמנה מינימלית לשיטת מילוי ההזמנות שמשויכת לקישור הפעולה. |
FulfillmentType
סוג מילוי ההזמנות שמשויך לקישור לפעולה.
טיפוסים בני מנייה (enum) | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
לא צוין סוג מילוי ההזמנות. |
FULFILLMENT_TYPE_DELIVERY |
סוג האספקה הוא מסירה. |
FULFILLMENT_TYPE_PICKUP |
סוג ההזמנה הוא איסוף. |
AvailableDay
זמינות ברמת היום.
ייצוג ב-JSON |
---|
{
"fulfillmentDate": {
object ( |
שדות | |
---|---|
fulfillment |
חובה. תאריך זמין לשיטת הטיפול בהזמנה. ההנחה היא באזור הזמן של המוכר. |
last |
חובה. חותמת זמן של 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 יכול להיות רק אחת מהאפשרויות הבאות: |
|
no |
אין עמלה על שיטת המילוי. |
base |
העמלה הבסיסית שמשויכת לשיטת מילוי ההזמנות. |
fixed |
העמלה הקבועה שמשויכת לשיטת המילוי. |
NoFee
אין שדות לסוג הזה.
אין עמלה על שיטת המילוי המשויכת לקישור לפעולה.
MinimumFee
העמלה המינימלית הנדרשת לשיטת מילוי ההזמנות שמשויכת לקישור הפעולה.
ייצוג ב-JSON |
---|
{
"baseFeeAmount": {
object ( |
שדות | |
---|---|
base |
חובה. סכום העמלה הבסיסית של שיטת המילוי. |
FixedFee
העמלה הקבועה הנדרשת לשיטת הביצוע המשויכת לקישור הפעולה.
ייצוג ב-JSON |
---|
{
"amount": {
object ( |
שדות | |
---|---|
amount |
חובה. סכום העמלה הקבועה של שיטת המילוי. |
FoodOrderingMetadata
מטא-נתונים של קישורים לפעולות להזמנת אוכל.
ייצוג JSON |
---|
{ "feeDetails": [ { object ( |
שדות | |
---|---|
fee |
פרטי החיובים שהמשתמש חויב עליהם בנוסף לסכום הכולל של הפריט. חוזר על עצמו עבור סוגי עמלות שונים, כמו עמלת שירות, עמלת משלוח וכו'. |
advance |
פרטים על תמיכה בהזמנות מתקדמות, שנקראת גם 'הזמנה מראש', שבה המשתמשים יכולים לבצע הזמנה לתאריך מאוחר יותר. |
שדה האיחוד fulfillment_duration_options . משך זמן האספקה של ההזמנה מאישור ההזמנה. בהזמנות ממסעדות, משך הזמן עד שהאוכל יגיע. בהזמנות באיסוף עצמי, יש לציין את משך הזמן עד שהאוכל יהיה מוכן לאיסוף. הערך של fulfillment_duration_options יכול להיות רק אחת מהאפשרויות הבאות: |
|
fulfillment |
משך קבוע. לדוגמה: 30 דקות. משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-' |
fulfillment |
טווח זמן. דוגמאות: * 30 דקות עד 45 דקות * יותר מ-30 דקות * פחות מ-50 דקות |
FeeDetails
פרטי העמלות.
ייצוג JSON |
---|
{ "type": enum ( |
שדות | |
---|---|
type |
סוג העמלה. (חובה) |
fee |
סכום העמלה במטבע היחידה, כאחוז מערך עגלת הקניות או בשילוב של שניהם. (חובה) |
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 ( |
שדות | |
---|---|
cart |
העמלה במונחים של אחוז מערך עגלת הקניות. תומכת בטווח (מוגבל ולא מוגבל) או באחוז קבוע. הערך צריך להיות בין 0 ל-100. דוגמאות: * 5.5% קבוע * לפחות 5.5% * לכל היותר 5.5% * 4.5% עד 5.5% |
שדה האיחוד amount_options . אפשרויות לציון סכום כספי. הערך של amount_options יכול להיות רק אחת מהאפשרויות הבאות: |
|
amount |
סכום קבוע. לדוגמה, USD 3.5. |
amount |
טווח הסכום. דוגמאות: * 3.5 USD עד USD 5.5 * לפחות USD 3.5 * לכל היותר 5.5 USD |
amount |
סכום לא ידוע. |
כסף
מייצג סכום כסף בסוג המטבע שלו.
ייצוג JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currency |
קוד המטבע בן שלוש האותיות שמוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה: אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ל- +999,999,999, כולל. אם הערך של |
MoneyRange
Wrapper לטווח של סכומים כספיים שאפשר להגדיר להם גבולות או הגבלות. צריך לציין לפחות אחד מהשדות minAmount ו-maxAmount.
ייצוג ב-JSON |
---|
{ "minAmount": { object ( |
שדות | |
---|---|
min |
סכום מינימלי. |
max |
הסכום המקסימלי. |
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 |
value |
טווח ערכים שיכול להיות גם פתוח או מוגבל. דוגמאות: * לפחות 5.5 * 5.5 * 5.5 עד 6.5 |
RangeValue
טווח ערכים כזה ש-minValue
< maxValue
. נדרש לפחות אחד מהערכים minValue
ו-maxValue
.
ייצוג JSON |
---|
{ "minValue": number, "maxValue": number } |
שדות | |
---|---|
min |
ערך מינימלי. |
max |
ערך מקסימלי. |
DurationRange
תוכנת wrapper למשך טווח זמן שאי אפשר לתחום או לתחום. חובה לציין לפחות אחד מהמשכים minDuration ו-maxDuration.
ייצוג JSON |
---|
{ "minDuration": string, "maxDuration": string } |
שדות | |
---|---|
min |
משך זמן מינימלי. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
max |
משך זמן מקסימלי. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
AdvanceOrderDetails
לקבלת תמיכה בהזמנה מראש.
ייצוג ב-JSON |
---|
{ "isSupported": boolean } |
שדות | |
---|---|
is |
הערך true אם יש תמיכה בהזמנות מראש, שנקראות גם 'הזמנה מראש'. (חובה) |
EventMetadata
מידע נוסף על קישור הפעולה, שהוא ייחודי לתחום האירועים.
ייצוג ב-JSON |
---|
{
"surface": enum ( |
שדות | |
---|---|
surface |
מיקום אירוע מוגדר מראש שמשויך לקישור לפעולה. הנתון הזה משמש רק את התחום 'אירועים'. |
פלטפורמה
מיקום אירוע מוגדר מראש שמשויך לקישור לפעולה. הוא משמש רק לקטגוריית 'אירועים'.
טיפוסים בני מנייה (enum) | |
---|---|
SURFACE_UNSPECIFIED |
המשטח לא צוין. |
SURFACE_SEARCH |
הקישור לפעולה מבצע הזמנת כרטיס לאירוע בחיפוש Google. |
SURFACE_YOUTUBE |
הקישור לפעולה הוא הזמנת כרטיס לאירוע ב-YouTube. |
SURFACE_ADS |
הקישור לפעולה הוא לחיצה על מודעה של האירוע. |