- ייצוג ב-JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- תאריך
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- Money
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Surface
כתובת 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 |
מטא-נתונים של קישורים להזמנה ממסעדה. תומך בסוג הפעולה: * |
eventMetadata |
מידע נוסף על קישור לפעולה, שייחודי לקטגוריית ישויות (vertical) של האירועים. |
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. הפעם האחרונה שבה משתמש יכול היה להזמין ולקבל פריטים באמצעות לדוגמה, אם תאריך האספקה (fulfillmentDate) הוא 2020-08-10: – ערך של המועד האחרון לביצוע הזמנה (lastOrderingTime) 2020-08-10 18:00 אומר שלקוח צריך לבצע את ההזמנה עד השעה 18:00 באותו יום כדי לקבל אותה ב-2020-08-10. – ערך של lastOrderingTime 2020-08-08 20:00 פירושו שלקוח צריך לבצע את ההזמנה עד השעה 20:00 ב-8 באוגוסט כדי לקבל אותה ב-10 באוגוסט. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
תאריך
מייצג תאריך מלא או חלקי ביומן, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שהם לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. הערך הזה יכול לייצג את אחת מהאפשרויות הבאות:
- תאריך מלא, עם ערכים שאינם אפס לשנה, לחודש וליום.
- חודש ויום, עם שנה אפס (לדוגמה, יום נישואין).
- שנה לבד, עם חודש אפס ויום אפס.
- שנה וחודש, עם יום אפס (לדוגמה, תאריך התפוגה של כרטיס אשראי).
סוגים קשורים:
google.type.TimeOfDaygoogle.type.DateTimegoogle.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 דוגמאות: * עמלה קבועה: 0 ש"ח (ללא עמלה), 6 ש"ח * טווח של עמלה קבועה: 4 ש"ח (מינימום), 12 ש"ח (מקסימום), 20-24 ש"ח * אחוז מגודל העגלה: 15.5%, 10%-20%, 10% (מינימום), 15% (מקסימום) * שילוב של טווח ואחוז: 25.5% ו-10 ש"ח (מינימום), 25.5% ו-18 ש"ח (מקסימום), 10% ו-6-10 ש"ח, 10.5%-20% ו-10-14 ש"ח
| ייצוג ב-JSON |
|---|
{ "cartPercentage": { object ( |
| שדות | |
|---|---|
cartPercentage |
עמלה כאחוז מערך עגלת הקניות. תומך בטווח (מוגבל ולא מוגבל) או באחוז קבוע. הערך צריך להיות בין 0 ל-100. דוגמאות: * קבוע 5.5% * לפחות 5.5% * לכל היותר 5.5% * 4.5% עד 5.5% |
שדה איחוד amount_options. אפשרויות לציין סכום כספי. הערך amount_options יכול להיות רק אחד מהבאים: |
|
amount |
סכום קבוע. לדוגמה, 3.5 USD. |
amountRange |
טווח הסכומים. דוגמאות: * 3.5 USD to 5.5 USD * At least 3.5 USD * At most 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
עוטף ערך מספרי שיכול להיות טווח או ערך קבוע. 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
עוטף לטווח של משך זמן שיכול להיות מוגבל או לא מוגבל. צריך לציין לפחות את משך הזמן המינימלי או המקסימלי.
| ייצוג ב-JSON |
|---|
{ "minDuration": string, "maxDuration": string } |
| שדות | |
|---|---|
minDuration |
משך מינימלי. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה, שמסתיים ב-' |
maxDuration |
משך הזמן המקסימלי. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה, שמסתיים ב-' |
AdvanceOrderDetails
לקבלת תמיכה בהזמנה מראש.
| ייצוג ב-JSON |
|---|
{ "isSupported": boolean } |
| שדות | |
|---|---|
isSupported |
הערך הוא True אם יש תמיכה בהזמנות מראש. (חובה) |
EventMetadata
מידע נוסף על קישור לפעולה, שייחודי לקטגוריית ישויות (vertical) של האירועים.
| ייצוג ב-JSON |
|---|
{
"surface": enum ( |
| שדות | |
|---|---|
surface |
משטח אירועים שנקבע מראש ומשויך לקישור לפעולה. המאפיין הזה משמש רק לקטגוריית ישויות (vertical) של אירועים. |
פלטפורמה
משטח אירועים שנקבע מראש ומשויך לקישור לפעולה. המאפיין הזה משמש רק לקטגוריית ישויות (vertical) של אירועים.
| טיפוסים בני מנייה (enum) | |
|---|---|
SURFACE_UNSPECIFIED |
לא צוין משטח. |
SURFACE_SEARCH |
הקישור לפעולה הוא הזמנת כרטיס לאירוע בחיפוש Google. |
SURFACE_YOUTUBE |
הקישור לפעולה הוא הזמנת כרטיס לאירוע ב-YouTube. |
SURFACE_ADS |
הקישור לפעולה הוא קליק על מודעה של האירוע. |