پس از اینکه مشتری سفارشی را ارسال کرد، میتوانید با ارسال پیام بهروزرسانی سفارش به 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" } } } }
برای اطلاع از اصول اولیه اجرای بهروزرسانیهای سفارش برای پروژه، راهنمای بهروزرسانی سفارش Async را بخوانید.
بخشهای بعدی نمونههایی را برای سناریوهای پیشرفتهتر بهروزرسانی سفارش ارائه میکنند.
وضعیت رد شده
مثالهای زیر یک AsyncOrderUpdateRequestMessage
را برای سفارشهایی که به دلایل مختلف رد شدهاند نشان میدهد. برخی از مثالهای دلایل رد زمانی است که رستوران دیگر نمیتواند سفارش را انجام دهد یا زمانی که آدرس تحویل مرتبط با سفارش خارج از محدوده است.
مورد استفاده | نحوه پیاده سازی |
---|---|
مورد استفاده 1: سفارش رد می شود زیرا ارائه دهنده نمی تواند با رستوران تماس بگیرد یا رستوران نمی تواند سفارش را انجام دهد. | یک OrderUpdate با وضعیت REJECTED به Google ارسال کنید. باید actionOrderId , userVisibleOrderId , orderManagementActions , rejectionInfo و foodOrderError از نوع خطا NO_CAPACITY داشته باشد . |
مورد استفاده 2: سفارش رد می شود زیرا راننده در دسترس نیست یا آدرس تحویل خارج از محدوده است. | یک OrderUpdate با وضعیت REJECTED به Google ارسال کنید. باید actionOrderId , userVisibleOrderId , orderManagementActions , rejectionInfo و foodOrderError از نوع خطا OUT_OF_SERVICE_AREA داشته باشد . |
مورد استفاده 3: سفارش رد می شود زیرا رستوران به طور غیر منتظره بسته شده یا در حال بسته شدن است. | یک OrderUpdate با وضعیت REJECTED به Google ارسال کنید. باید actionOrderId , userVisibleOrderId , orderManagementActions , rejectionInfo و foodOrderError از نوع خطا CLOSED داشته باشد . |
مورد استفاده 4: سفارش رد می شود زیرا برخی از اقلام موجود نیست. | یک OrderUpdate با وضعیت REJECTED به Google ارسال کنید. باید actionOrderId , userVisibleOrderId , orderManagementActions , rejectionInfo و foodOrderError از نوع خطا AVAILABILITY_CHANGED داشته باشد . |
مورد استفاده 5: سفارش به دلایل نامشخص یا طبقه بندی نشده رد می شود. | یک OrderUpdate با وضعیت REJECTED به Google ارسال کنید. باید 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: سفارش با درخواست مشتری لغو می شود | یک OrderUpdate با وضعیت CANCELLED به Google ارسال کنید. باید 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: سفارش انجام شده است | یک OrderUpdate با وضعیت FULFILLED به Google ارسال کنید. باید 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: سفارش تحویل در حال انتقال است. | یک OrderUpdate با وضعیت IN_TRANSIT به Google ارسال کنید. باید 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: سفارش آماده تحویل است. | یک OrderUpdate با وضعیت READY_FOR_PICKUP به Google ارسال کنید. باید 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: سفارش توسط رستوران در حال آماده سازی است. | یک OrderUpdate با وضعیت IN_PREPARATION به Google ارسال کنید. باید 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: زمان برآوردی انجام باید به روز شود. | یک OrderUpdate با وضعیت سفارش، actionOrderId ، userVisibleOrderId ، orderManagementAction ، و estimatedFulfillmentTime به روز شده به Google ارسال کنید. |
مورد استفاده 2: قیمت کل سفارش باید به روز شود. | یک OrderUpdate با وضعیت سفارش، actionOrderId ، userVisibleOrderId ، orderManagementAction ، estimatedFulfillmentTime ، و به روز شده totalPrice به Google ارسال کنید. |
مورد استفاده 3: اقدامات مدیریت سفارش سفارش باید به روز شود. | یک OrderUpdate با وضعیت سفارش، actionOrderId ، userVisibleOrderId ، estimatedFulfillmentTime ، و orderManagementActions به روز شده به Google ارسال کنید. |
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" } } } }