Une fois qu'un client a passé sa commande, vous pouvez l'informer de toute modification en lui envoyant un message de mise à jour de la commande. Google relaie ensuite ce message au client dans l'UI de commande.
Les raisons les plus courantes sont les suivantes:
- Le délai de traitement estimé de la commande devient disponible ou change.
- L'état d'une commande change.
- La commande ne peut plus être traitée.
- Le prix d'un élément de menu inclus dans la commande a changé.
- Le client dispose d'une nouvelle manière de gérer sa commande, telle qu'un numéro de téléphone ou de service client.
- Le reçu de la commande est disponible.
L'exemple suivant utilise une mise à jour de commande pour faire passer la commande d'un client de CREATED à CONFIRMED après que le restaurant a confirmé la commande:
| Cas d'utilisation | Mise en œuvre |
|---|---|
| Cas d'utilisation 1:le restaurant confirme la commande. | Un OrderUpdate avec l'état CONFIRMED est envoyé à Google. Il doit contenir actionOrderId, userVisibleOrderId, orderManagementActions et 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"
}
}
}
}
Pour connaître les principes de base de la mise à jour des commandes pour votre projet, consultez le guide Mises à jour des commandes asynchrones.
Les sections suivantes fournissent des exemples de scénarios de mise à jour de commande plus avancés.
État du refus
Les exemples ci-dessous illustrent un AsyncOrderUpdateRequestMessage pour les commandes refusées pour diverses raisons. C'est par exemple le cas lorsque le restaurant ne peut plus traiter la commande ou que l'adresse de livraison associée à la commande est hors limites.
| Cas d'utilisation | Mise en œuvre |
|---|---|
| Cas d'utilisation 1:la commande a été refusée, car le fournisseur ne peut pas contacter le restaurant ou celui-ci ne peut pas traiter la commande. | Envoyez à Google un OrderUpdate dont l'état est REJECTED. Il doit comporter actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo et foodOrderError de type NO_CAPACITY. |
| Cas d'utilisation 2:la commande a été refusée, car le livreur n'est pas disponible ou l'adresse de livraison est hors de portée. | Envoyez à Google un OrderUpdate dont l'état est REJECTED. Il doit comporter actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo et foodOrderError de type OUT_OF_SERVICE_AREA. |
| Cas d'utilisation 3:la commande est refusée, car le restaurant est fermé de manière inattendue ou est sur le point de fermer. | Envoyez à Google un OrderUpdate dont l'état est REJECTED. Il doit comporter actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo et foodOrderError de type CLOSED. |
| Cas d'utilisation 4:la commande est refusée, car certains articles ne sont pas disponibles. | Envoyez à Google un OrderUpdate dont l'état est REJECTED. Il doit comporter actionOrderId, userVisibleOrderId, orderManagementActions, rejectionInfo et foodOrderError de type AVAILABILITY_CHANGED. |
| Cas d'utilisation 5:la commande est refusée pour des raisons inconnues ou sans catégorie. | Envoyez à Google un OrderUpdate dont l'état est REJECTED. Les champs actionOrderId, userVisibleOrderId, orderManagementActions et rejectionInfo doivent être associés au type d'erreur 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"
}
}
}
]
}
}
}
État "Annulé"
L'exemple ci-dessous illustre un AsyncOrderUpdateRequestMessage pour les commandes annulées par la demande du client.
| Cas d'utilisation | Mise en œuvre |
|---|---|
| Cas d'utilisation 1:la commande est annulée à la demande du client. | Envoyez à Google un OrderUpdate dont l'état est CANCELLED. Il doit contenir actionOrderId, userVisibleOrderId, orderManagementActions et 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"
}
}
}
]
}
}
}
État de traitement de la commande
L'exemple ci-dessous illustre un AsyncOrderUpdateRequestMessage pour les commandes traitées.
| Cas d'utilisation | Mise en œuvre |
|---|---|
| Cas d'utilisation 1:la commande est traitée. | Envoyez à Google un OrderUpdate dont l'état est FULFILLED. Il doit contenir actionOrderId, userVisibleOrderId et 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"
}
}
}
]
}
}
}
État en transit
L'exemple ci-dessous montre un AsyncOrderUpdateRequestMessage pour les commandes en livraison vers le client.
| Cas d'utilisation | Mise en œuvre |
|---|---|
| Cas d'utilisation 1:la commande est en cours d'acheminement. | Envoyez à Google un OrderUpdate dont l'état est IN_TRANSIT. Il doit contenir actionOrderId, userVisibleOrderId, orderManagementActions et 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"
}
}
}
}
État "prêt à retirer"
L'exemple ci-dessous illustre un AsyncOrderUpdateRequestMessage pour les commandes prêtes à être retirées par le client.
| Cas d'utilisation | Mise en œuvre |
|---|---|
| Cas d'utilisation 1:la commande est prête à être retirée. | Envoyez à Google un OrderUpdate ayant l'état READY_FOR_PICKUP. Il doit contenir actionOrderId, userVisibleOrderId, orderManagementActions et 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"
}
}
}
}
État de la préparation de l'aliment
L'exemple ci-dessous illustre un AsyncOrderUpdateRequestMessage pour les commandes préparées par le restaurant.
| Cas d'utilisation | Mise en œuvre |
|---|---|
| Cas d'utilisation 1:la commande est en cours de préparation par le restaurant. | Envoyez à Google un OrderUpdate ayant l'état IN_PREPARATION. Il doit contenir actionOrderId, userVisibleOrderId, orderManagementActions et 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"
}
}
}
}
État "Commande modifiée"
Les exemples ci-dessous illustrent un AsyncOrderUpdateRequestMessage pour différentes modifications apportées à la commande d'un client.
| Cas d'utilisation 1:le temps de traitement estimé doit être mis à jour. | Envoyez une requête OrderUpdate à Google avec l'état de la commande, actionOrderId, userVisibleOrderId, orderManagementAction et l'identifiant estimatedFulfillmentTime mis à jour. |
| Cas d'utilisation 2 : le prix total de la commande doit être mis à jour. | Envoyez une requête OrderUpdate à Google avec l'état de la commande (actionOrderId, userVisibleOrderId, orderManagementAction, estimatedFulfillmentTime) et l'autorisation totalPrice mise à jour. |
| Cas d'utilisation 3:les actions de gestion des commandes doivent être mises à jour. | Envoyez une requête OrderUpdate à Google avec l'état de la commande, actionOrderId, userVisibleOrderId, estimatedFulfillmentTime et l'identifiant orderManagementActions mis à jour. |
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"
}
}
}
}