אחרי שלקוח שולח הזמנה, אתם יכולים לעדכן אותו לגבי שינויים בהזמנה על ידי שליחת הודעה ל-Google. לאחר מכן Google מעבירה את ההודעה הזו ללקוח בממשק המשתמש של ההזמנה.
בין הסיבות הנפוצות לשליחת עדכוני הזמנה:
- מועד הטיפול המשוער בהזמנה זמין או משתנה.
- הסטטוס של ההזמנה משתנה.
- לא ניתן יותר למלא את ההזמנה.
- המחיר של פריט בתפריט שכלול בהזמנה השתנה.
- הלקוח יקבל דרך חדשה לנהל את ההזמנה, כמו מספר טלפון של תמיכת לקוחות או של המסעדה.
- הקבלה על ההזמנה תהיה זמינה.
לדוגמה, בדוגמה הבאה נעשה שימוש בעדכון הזמנה כדי לשנות את הסטטוס של הזמנה של לקוח מ-CREATED ל-CONFIRMED אחרי שהמסעדה אישרה את ההזמנה:
| תרחיש לדוגמה | איך מטמיעים |
|---|---|
| תרחיש לדוגמה 1: המסעדה מאשרת את ההזמנה | OrderUpdate עם סטטוס CONFIRMED נשלח ל-Google. חייבים להופיע בה actionOrderId, userVisibleOrderId, orderManagementActions ו-estimatedFulfillmentTime. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "CONFIRMED", "label": "Provider confirmed" }, "receipt": { "userVisibleOrderId": "userVisibleId1234" }, "updateTime": "2017-07-17T12:00:00Z", "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z" } } } }
במדריך עדכוני הזמנות אסינכררוניים מוסבר על העקרונות הבסיסיים של הטמעת עדכוני הזמנות בפרויקט.
בקטעים הבאים מפורטות דוגמאות לתרחישי עדכון מתקדמים יותר של הזמנות.
סטטוס 'נדחה'
בדוגמאות הבאות מוצג AsyncOrderUpdateRequestMessage להזמנות שנדחו מסיבות שונות. דוגמאות לגורמים לדחייה: המסעדה לא יכולה יותר למלא את ההזמנה או שכתובת המשלוח שמשויכת להזמנה לא נמצאת בטווח.
| תרחיש לדוגמה | איך מטמיעים |
|---|---|
| תרחיש לדוגמה 1: ההזמנה נדחית כי הספק לא יכול ליצור קשר עם המסעדה או שהמסעדה לא יכולה למלא את ההזמנה. | שולחים ל-Google OrderUpdate עם סטטוס REJECTED. הוא חייב לכלול את השגיאות actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo ו-foodOrderError מסוג NO_CAPACITY. |
| תרחיש לדוגמה 2: ההזמנה נדחית כי הנהג לא זמין או שכתובת המסירה לא נמצאת בטווח. | שולחים ל-Google OrderUpdate עם סטטוס REJECTED. הוא חייב לכלול את השגיאות actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo ו-foodOrderError מסוג OUT_OF_SERVICE_AREA. |
| תרחיש לדוגמה 3: ההזמנה נדחית כי המסעדה סגורה באופן בלתי צפוי או כי היא עומדת להיסגר. | שולחים ל-Google OrderUpdate עם סטטוס REJECTED. הוא חייב לכלול את השגיאות actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo ו-foodOrderError מסוג CLOSED. |
| תרחיש לדוגמה 4: ההזמנה נדחית כי חלק מהפריטים חסרים במלאי. | שולחים ל-Google OrderUpdate עם סטטוס REJECTED. הוא חייב לכלול את הערכים actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo ו-foodOrderError מסוג השגיאה AVAILABILITY_CHANGED. |
| תרחיש שימוש 5: ההזמנה נדחתה מסיבות לא ידועות או מסיבות שלא מסווגות. | שולחים ל-Google OrderUpdate עם סטטוס REJECTED. הוא חייב לכלול את השדות actionOrderId, userVisibleOrderId, orderManagementActions ו-rejectionInfo מסוג השגיאה UNKNOWN. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "REJECTED", "label": "Order rejected" }, "updateTime": "2017-05-10T02:30:00.000Z", "rejectionInfo": { "type": "UNKNOWN", "reason": "Sorry, the restaurant cannot take your order right now." }, "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "foodOrderErrors": [ { "error": "NO_CAPACITY", "description": "Sorry, the restaurant cannot take your order right now." } ] } } } }
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "REJECTED", "label": "Order rejected" }, "updateTime": "2017-05-10T02:30:00.000Z", "rejectionInfo": { "type": "UNKNOWN", "reason": "Sorry, delivery is currently not available to your address." }, "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "foodOrderErrors": [ { "error": "OUT_OF_SERVICE_AREA", "description": "Sorry, delivery is currently not available to your address." } ] } } } }
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "REJECTED", "label": "Order rejected" }, "updateTime": "2017-05-10T02:30:00.000Z", "rejectionInfo": { "type": "UNKNOWN", "reason": "Sorry, the restaurant is closed unexpectedly." }, "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "foodOrderErrors": [ { "error": "CLOSED", "description": "Sorry, the restaurant is closed unexpectedly." } ] } } } }
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "REJECTED", "label": "Order rejected" }, "updateTime": "2017-05-10T02:30:00.000Z", "rejectionInfo": { "type": "UNKNOWN", "reason": "Sorry, some of items are not available right now." }, "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "foodOrderErrors": [ { "error": "AVAILABILITY_CHANGED", "id": "sample_menu_item_id", "description": "Sorry, some of the items are not available right now." } ] } } } }
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "REJECTED", "label": "Order rejected" }, "updateTime": "2017-05-10T02:30:00.000Z", "rejectionInfo": { "type": "UNKNOWN", "reason": "Sorry, your order is rejected." }, "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ] } } }
סטטוס 'מבוטל'
בדוגמה הבאה מוצג AsyncOrderUpdateRequestMessage להזמנות שבוטלו על פי בקשת הלקוח.
| תרחיש לדוגמה | איך מטמיעים |
|---|---|
| תרחיש לדוגמה 1: ההזמנה בוטלה לבקשת הלקוח | שולחים ל-Google OrderUpdate עם סטטוס CANCELLED. חייבים להופיע בה actionOrderId, userVisibleOrderId, orderManagementActions ו-cancellationInfo. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "CANCELLED", "label": "Order cancelled" }, "updateTime": "2017-05-10T02:30:00.000Z", "cancellationInfo": { "reason": "Customer requested" }, "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ] } } }
סטטוס 'הזמנה שבוצעה'
בדוגמה הבאה מוצג AsyncOrderUpdateRequestMessage להזמנות שהושלמו.
| תרחיש לדוגמה | איך מטמיעים |
|---|---|
| תרחיש לדוגמה 1: ההזמנה הושלמה | שולחים ל-Google OrderUpdate עם סטטוס FULFILLED. חובה להוסיף את actionOrderId,
userVisibleOrderId ו-orderManagementActions. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "FULFILLED", "label": "Order delivered" }, "updateTime": "2017-05-10T02:30:00.000Z", "fulfillmentInfo": { "deliveryTime": "2017-05-10T02:30:00.000Z" }, "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ] } } }
סטטוס 'בדרך'
הדוגמה הבאה מראה AsyncOrderUpdateRequestMessage להזמנות במשלוח שנמצאות בדרך ללקוח.
| תרחיש לדוגמה | איך מטמיעים |
|---|---|
| תרחיש לדוגמה 1: הזמנת משלוח בדרך. | שולחים ל-Google OrderUpdate עם סטטוס IN_TRANSIT. חייבים להופיע בה actionOrderId, userVisibleOrderId, orderManagementActions ו-estimatedFulfillmentTime. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "IN_TRANSIT", "label": "Order is on the way" }, "inTransitInfo": { "updatedTime": "2017-07-17T12:00:00Z" }, "updateTime": "2017-07-17T12:00:00Z", "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "estimatedFulfillmentTimeIso8601": "PT20M" } } } }
סטטוס 'מוכנה לאיסוף'
הדוגמה הבאה מראה AsyncOrderUpdateRequestMessage להזמנות שזמינות לאיסוף על ידי הלקוח.
| תרחיש לדוגמה | איך מטמיעים |
|---|---|
| תרחיש לדוגמה 1: ההזמנה מוכנה לאיסוף. | שולחים ל-Google OrderUpdate עם סטטוס READY_FOR_PICKUP. חייבים להופיע בה actionOrderId, userVisibleOrderId, orderManagementActions ו-estimatedFulfillmentTime. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "READY_FOR_PICKUP", "label": "Order is ready for pickup" }, "updateTime": "2018-04-15T12:00:00Z", "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "estimatedFulfillmentTimeIso8601": "PT20M" } } } }
סטטוס 'האוכל בהכנה'
בדוגמה הבאה מוצג AsyncOrderUpdateRequestMessage להזמנות שהמסעדה מכינה.
| תרחיש לדוגמה | איך מטמיעים |
|---|---|
| תרחיש לדוגמה 1: ההזמנה מוכנה במסעדה. | שולחים ל-Google OrderUpdate עם סטטוס IN_PREPARATION. חייבים להופיע בה actionOrderId, userVisibleOrderId, orderManagementActions ו-estimatedFulfillmentTime. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "IN_PREPARATION", "label": "Order is being prepared" }, "updateTime": "2018-04-15T11:30:00Z", "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "estimatedFulfillmentTimeIso8601": "PT20M" } } } }
סטטוס ההזמנה השתנה
בדוגמאות הבאות מוצג AsyncOrderUpdateRequestMessage לשינויים שונים שבוצעו בהזמנה של לקוח.
| תרחיש לדוגמה 1: צריך לעדכן את זמן האספקה המשוער. | שולחים ל-Google OrderUpdate עם סטטוס ההזמנה, actionOrderId, userVisibleOrderId, orderManagementAction וה-estimatedFulfillmentTime המעודכן. |
| תרחיש לדוגמה 2: צריך לעדכן את המחיר הכולל של ההזמנה. | שולחים ל-Google OrderUpdate עם סטטוס ההזמנה, actionOrderId, userVisibleOrderId, orderManagementAction, estimatedFulfillmentTime ו-totalPrice המעודכן. |
| תרחיש לדוגמה 3: צריך לעדכן את הפעולות של ניהול ההזמנה. | שולחים ל-Google OrderUpdate עם סטטוס ההזמנה, actionOrderId, userVisibleOrderId, estimatedFulfillmentTime וה-orderManagementActions המעודכן. |
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "CONFIRMED", "label": "Provider confirmed" }, "receipt": { "userVisibleOrderId": "userVisibleId1234" }, "updateTime": "2017-07-17T12:00:00Z", "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z" } } } }
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "CONFIRMED", "label": "Provider confirmed" }, "receipt": { "userVisibleOrderId": "userVisibleId1234" }, "totalPrice": { "type": "ESTIMATE", "amount": { "currencyCode": "USD", "units": "20", "nanos": 500000000 } }, "updateTime": "2017-07-17T12:00:00Z", "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z" } } } }
JSON
{ "isInSandbox": true, "customPushMessage": { "orderUpdate": { "actionOrderId": "sample_action_order_id", "orderState": { "state": "CONFIRMED", "label": "Provider confirmed" }, "receipt": { "userVisibleOrderId": "userVisibleId1234" }, "updateTime": "2017-07-17T12:00:00Z", "orderManagementActions": [ { "type": "CUSTOMER_SERVICE", "button": { "title": "Contact customer service", "openUrlAction": { "url": "mailto:support@example.com" } } }, { "type": "EMAIL", "button": { "title": "Email restaurant", "openUrlAction": { "url": "mailto:person@example.com" } } }, { "type": "CALL_RESTAURANT", "button": { "title": "Call restaurant", "openUrlAction": { "url": "tel:+16505554679" } } }, { "type": "CALL_DRIVER", "button": { "title": "Call driver", "openUrlAction": { "url": "tel:+16505554681" } } } ], "infoExtension": { "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension", "estimatedFulfillmentTimeIso8601": "2017-07-17T13:00:00Z/2017-07-17T13:30:00Z" } } } }