Gdy klient prześle zamówienie, możesz powiadomić go o zmianach w zamówienie, wysyłając do Google wiadomość o aktualizacji zamówienia. Google przekazuje te dane wiadomość do klienta w interfejsie do składania zamówień.
Oto częste powody wysyłania aktualizacji zamówień:
- Szacowany czas realizacji zamówienia stanie się dostępny lub zmieni się.
- Stan zamówienia się zmienia.
- Nie można już zrealizować tego zamówienia.
- Zmieniła się cena pozycji menu uwzględnionej w zamówieniu.
- Klient ma nowy sposób zarządzania zamówieniem, na przykład obsługę klienta czy numer telefonu do restauracji.
- Pojawi się potwierdzenie zamówienia.
W przykładzie poniżej użyto aktualizacji zamówienia do zmiany stanu
zamówienie klienta od CREATED do CONFIRMED po potwierdzeniu przez restaurację
zamówienie:
| Przypadek użycia | Sposób implementacji |
|---|---|
| Przypadek użycia 1: restauracja potwierdza zamówienie | Wysłano wiadomość OrderUpdate ze stanem CONFIRMED
o korzystaniu. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions i
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"
}
}
}
}
Podstawowe informacje na temat wdrażania aktualizacji zamówień w projekcie znajdziesz w przewodniku Asynchroniczne aktualizacje zamówień.
Kolejne sekcje zawierają przykłady bardziej zaawansowanych scenariuszy aktualizowania zamówień.
Stan: Odrzucono
Poniższe przykłady obrazują AsyncOrderUpdateRequestMessage dla:
zamówień, które zostały odrzucone z różnych powodów. Przykłady odrzucenia
Dzieje się tak, gdy restauracja nie może już zrealizować zamówienia lub gdy
adres dostawy powiązany z zamówieniem jest poza zakresem.
| Przypadek użycia | Sposób implementacji |
|---|---|
| Przypadek użycia 1: zamówienie zostało odrzucone, ponieważ usługodawca nie może się z nim skontaktować restauracja lub restauracja nie może zrealizować zamówienia. | Wyślij OrderUpdate ze stanem REJECTED do
Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions
rejectionInfo i foodOrderError typu błędu
NO_CAPACITY. |
| Przypadek użycia 2. Zamówienie zostało odrzucone, ponieważ sterownik jest niedostępny lub adres dostawy jest poza zakresem. | Wyślij OrderUpdate ze stanem REJECTED do
Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions
rejectionInfo i foodOrderError typu błędu
OUT_OF_SERVICE_AREA. |
| Przypadek użycia 3. Zamówienie zostało odrzucone, ponieważ restauracja jest zamknięta niespodziewanie lub się zamyka. | Wyślij OrderUpdate ze stanem REJECTED do
Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions
rejectionInfo i foodOrderError typu błędu
CLOSED. |
| Przypadek użycia 4: zamówienie zostało odrzucone, ponieważ niektóre produkty nie są dostępne w magazynie. | Wyślij OrderUpdate ze stanem REJECTED do
Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions
rejectionInfo i foodOrderError typu błędu
AVAILABILITY_CHANGED. |
| Przypadek użycia 5: zamówienie zostało odrzucone z powodu nieznanego lub bez kategorii . | Wyślij OrderUpdate ze stanem REJECTED do
Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions i
rejectionInfo typu błędu 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"
}
}
}
]
}
}
}
Stan anulowany
Poniższy przykład pokazuje AsyncOrderUpdateRequestMessage dla:
zamówień anulowanych na prośbę klienta.
| Przypadek użycia | Sposób implementacji |
|---|---|
| Przypadek użycia 1: zamówienie jest anulowane na prośbę klienta | Wyślij OrderUpdate ze stanem CANCELLED do
Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions i
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"
}
}
}
]
}
}
}
Stan realizacji
Poniższy przykład pokazuje AsyncOrderUpdateRequestMessage dla:
zrealizowane zamówienia.
| Przypadek użycia | Sposób implementacji |
|---|---|
| Przypadek użycia 1: zamówienie zostało zrealizowane | Wyślij OrderUpdate ze stanem FULFILLED do
Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId i 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"
}
}
}
]
}
}
}
Stan transportu
Poniższy przykład pokazuje AsyncOrderUpdateRequestMessage dla:
z dostawą do klienta.
| Przypadek użycia | Sposób implementacji |
|---|---|
| Przypadek użycia 1: zamówienie jest w drodze. | Wyślij: OrderUpdate ze stanem IN_TRANSIT
o korzystaniu. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions i
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"
}
}
}
}
Stan gotowości do odbioru
Poniższy przykład pokazuje AsyncOrderUpdateRequestMessage dla:
gotowych do odbioru przez klienta.
| Przypadek użycia | Sposób implementacji |
|---|---|
| Przypadek użycia 1: zamówienie jest gotowe do odbioru. | Wyślij OrderUpdate z: READY_FOR_PICKUP
do Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions i
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"
}
}
}
}
Stan jedzenia w trakcie przygotowywania
Poniższy przykład pokazuje AsyncOrderUpdateRequestMessage dla:
przygotowywane przez restaurację zamówienia.
| Przypadek użycia | Sposób implementacji |
|---|---|
| Przypadek użycia 1. Restauracja przygotowuje zamówienie. | Wyślij OrderUpdate z: IN_PREPARATION
do Google. Musi zawierać te wartości: actionOrderId,
userVisibleOrderId, orderManagementActions i
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"
}
}
}
}
Zmiana stanu zamówienia
Poniższe przykłady obrazują AsyncOrderUpdateRequestMessage dla:
różnych zmian w zamówieniu klienta.
| Przypadek użycia 1: szacowany czas realizacji zamówienia należy zaktualizować. | Wyślij do Google OrderUpdate ze stanem zamówienia,
actionOrderId, userVisibleOrderId
orderManagementAction i zaktualizowane
estimatedFulfillmentTime. |
| Przypadek użycia 2. Musisz zaktualizować łączną cenę zamówienia. | Wyślij do Google OrderUpdate ze stanem zamówienia,
actionOrderId, userVisibleOrderId
orderManagementAction, estimatedFulfillmentTime,
oraz totalPrice. |
| Przypadek użycia 3. Działania związane z zarządzaniem zamówieniem muszą być Zaktualizowano. | Wyślij do Google OrderUpdate ze stanem zamówienia,
actionOrderId, userVisibleOrderId
estimatedFulfillmentTime i zaktualizowane
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"
}
}
}
}