Bir müşteri sipariş gönderdikten sonra Google'a sipariş güncelleme mesajı göndererek müşteriyi siparişteki değişiklikler hakkında bilgilendirebilirsiniz. Ardından Google, bu mesajı sipariş kullanıcı arayüzünde müşteriye iletir.
Sipariş güncellemelerinin gönderilmesinin yaygın nedenleri şunlardır:
- Sipariş için tahmini tamamlanma zamanı gösterilir veya değişir.
- Bir siparişin durumu değişir.
- Sipariş artık karşılanamıyor.
- Siparişe dahil edilen bir menü öğesinin fiyatı değişti.
- Müşteri, siparişini yönetmek için müşteri desteği veya restoran telefon numarası gibi yeni bir yönteme sahip olur.
- Sipariş makbuzu kullanılabilir hale gelir.
Örneğin, aşağıdaki örnekte restoran siparişi onayladıktan sonra müşterinin siparişinin durumunu CREATED yerine CONFIRMED olarak değiştirmek için bir sipariş güncellemesi kullanılmaktadır:
| Kullanım alanı | Nasıl uygulanır? |
|---|---|
| Kullanım alanı 1: Restoran siparişi onaylar | CONFIRMED durumuyla bir OrderUpdate Google'a gönderilir. actionOrderId,
userVisibleOrderId, orderManagementActions ve
estimatedFulfillmentTime olmalıdır. |
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" } } } }
Projeniz için sipariş güncellemelerini uygulamayla ilgili temel bilgiler için Asenkron sipariş güncellemeleri kılavuzunu okuyun.
Aşağıdaki bölümlerde, daha gelişmiş sipariş güncelleme senaryoları için örnekler verilmiştir.
Reddedildi durumu
Aşağıdaki örneklerde, çeşitli nedenlerle reddedilen siparişler için AsyncOrderUpdateRequestMessage gösterilmektedir. Reddetme nedenlerinden bazıları, restoranın artık siparişi yerine getirememesi veya siparişle ilişkili teslimat adresinin kapsam dışında olmasıdır.
| Kullanım alanı | Nasıl uygulanır? |
|---|---|
| Kullanım alanı 1: Sağlayıcı restoranla iletişime geçemediği veya restoran siparişi yerine getiremediği için sipariş reddedilir. | Google'a REJECTED durumuyla bir OrderUpdate gönderin. NO_CAPACITY hata türünde actionOrderId,
userVisibleOrderId, orderManagementActions,
rejectionInfo ve foodOrderError olmalıdır. |
| 2. kullanım alanı: Sürücü müsait olmadığı veya teslimat adresi kapsam dışında olduğu için sipariş reddedilir. | Google'a REJECTED durumuyla bir OrderUpdate gönderin. OUT_OF_SERVICE_AREA hata türünde actionOrderId,
userVisibleOrderId, orderManagementActions,
rejectionInfo ve foodOrderError olmalıdır. |
| Kullanım alanı 3: Restoran beklenmedik bir şekilde kapalı olduğu veya kapanmak üzere olduğu için sipariş reddedilir. | Google'a REJECTED durumuyla bir OrderUpdate gönderin. CLOSED hata türüne sahip actionOrderId,
userVisibleOrderId, orderManagementActions,
rejectionInfo ve foodOrderError olmalıdır. |
| Kullanım alanı 4: Öğelerin bazıları stokta olmadığı için sipariş reddedilir. | Google'a REJECTED durumuyla bir OrderUpdate gönderin. AVAILABILITY_CHANGED hata türünde actionOrderId,
userVisibleOrderId, orderManagementActions,
rejectionInfo ve foodOrderError olmalıdır. |
| Kullanım alanı 5: Sipariş, bilinmeyen veya sınıflandırılmamış nedenlerle reddedilir. | Google'a REJECTED durumuyla bir OrderUpdate gönderin. UNKNOWN türünde actionOrderId,
userVisibleOrderId, orderManagementActions ve
rejectionInfo olmalıdır. |
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" } } } ] } } }
İptal edildi durumu
Aşağıdaki örnekte, müşteri isteğiyle iptal edilen siparişler için bir AsyncOrderUpdateRequestMessage gösterilmektedir.
| Kullanım alanı | Nasıl uygulanır? |
|---|---|
| 1. kullanım alanı: Sipariş, müşterinin isteği üzerine iptal edilir | Google'a CANCELLED durumuyla bir OrderUpdate gönderin. actionOrderId,
userVisibleOrderId, orderManagementActions ve
cancellationInfo olmalıdır. |
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" } } } ] } } }
Tamamlandı durumu
Aşağıdaki örnekte, yerine getirilmiş siparişler için bir AsyncOrderUpdateRequestMessage gösterilmektedir.
| Kullanım alanı | Nasıl uygulanır? |
|---|---|
| 1. kullanım alanı: Sipariş karşılandı | Google'a FULFILLED durumuyla bir OrderUpdate gönderin. actionOrderId,
userVisibleOrderId ve orderManagementActions olmalıdır. |
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" } } } ] } } }
Transfer aşamasında durumu
Aşağıdaki örnekte, müşteriye teslimat sürecinde olan teslimat siparişleri için bir AsyncOrderUpdateRequestMessage gösterilmektedir.
| Kullanım alanı | Nasıl uygulanır? |
|---|---|
| 1. kullanım alanı: Teslimat siparişi transfer sürecinde. | Google'a IN_TRANSIT durumuyla bir OrderUpdate gönderin. actionOrderId,
userVisibleOrderId, orderManagementActions ve
estimatedFulfillmentTime olmalıdır. |
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" } } } }
Teslim alınmaya hazır durumu
Aşağıdaki örnekte, müşteri tarafından teslim alınmaya hazır siparişler için bir AsyncOrderUpdateRequestMessage gösterilmektedir.
| Kullanım alanı | Nasıl uygulanır? |
|---|---|
| 1. kullanım alanı: Sipariş teslim alınmaya hazır. | Google'a READY_FOR_PICKUP durumuyla bir OrderUpdate gönderin. actionOrderId,
userVisibleOrderId, orderManagementActions ve
estimatedFulfillmentTime olmalıdır. |
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" } } } }
Hazırlanmakta olan yemek durumu
Aşağıdaki örnekte, restoran tarafından hazırlanmakta olan siparişler için bir AsyncOrderUpdateRequestMessage gösterilmektedir.
| Kullanım alanı | Nasıl uygulanır? |
|---|---|
| 1. kullanım alanı: Sipariş restoran tarafından hazırlanıyor. | Google'a IN_PREPARATION durumuyla bir OrderUpdate gönderin. actionOrderId,
userVisibleOrderId, orderManagementActions ve
estimatedFulfillmentTime olmalıdır. |
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" } } } }
Sipariş durumu değişti
Aşağıdaki örneklerde, müşterinin siparişinde yapılan çeşitli değişiklikler için bir AsyncOrderUpdateRequestMessage gösterilmektedir.
| 1. kullanım alanı: Tahmini teslimat süresinin güncellenmesi gerekiyor. | Google'a sipariş durumunu, actionOrderId, userVisibleOrderId, orderManagementAction ve güncellenmiş estimatedFulfillmentTime ile birlikte bir OrderUpdate gönderin. |
| 2. kullanım alanı: Siparişin toplam fiyatının güncellenmesi gerekiyor. | Google'a sipariş durumunu,
actionOrderId, userVisibleOrderId,
orderManagementAction, estimatedFulfillmentTime ve güncellenmiş totalPrice ile birlikte bir OrderUpdate gönderin. |
| Kullanım alanı 3: Siparişin sipariş yönetimi işlemlerinin güncellenmesi gerekiyor. | Google'a sipariş durumunu, actionOrderId, userVisibleOrderId, estimatedFulfillmentTime ve güncellenmiş orderManagementActions ile birlikte bir OrderUpdate gönderin. |
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" } } } }