- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- OrderUpdate
- Digitare
- UserNotification
Aggiorna l'ordine dalle 3 alle AOG. Restituisce INVALID_REMOVED se l'ID dell'ordine è vuoto o non corrisponde a un ordine esistente.
Richiesta HTTP
PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
orderUpdate.order.merchantOrderId |
Obbligatorio: ID ordine interno assegnato dal commerciante. Questo ID deve essere univoco ed è obbligatorio per le successive operazioni di aggiornamento dell'ordine. Questo ID può essere impostato sul valore googleOrderId fornito o su qualsiasi altro valore univoco. Tieni presente che l'ID presentato agli utenti è userVisibileOrderId, che può essere un valore diverso e più facile da usare. La lunghezza massima consentita è 64 caratteri. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON | |
---|---|
{ "header": { object ( |
Campi | ||
---|---|---|
header |
Intestazione per la richiesta di aggiornamento dell'ordine. |
|
orderUpdate.type |
Deprecato: utilizza OrderUpdate.update_mask. Se type = SNAPSHOT, OrderUpdate.order deve essere l'intero ordine. Se type = ORDER_STATUS, questa è la modifica dello stato a livello di ordine. Vengono presi in considerazione solo order.last_update_time e questo stato verticale. Nota: type.ORDER_STATUS supporta solo gli aggiornamenti dello stato PurcahaseOrderExtension e non è previsto l'estensione di questo supporto. Consigliamo invece di utilizzare updateMask, poiché è più generico, estendibile e può essere utilizzato per tutti i verticali. |
|
orderUpdate.order.googleOrderId |
ID ordine assegnato da Google. |
|
orderUpdate.order.userVisibleOrderId |
L'ID rivolto all'utente che fa riferimento all'ordine corrente. Questo ID deve essere coerente con quello visualizzato per questo ordine in altri contesti, tra cui siti web, app ed email. |
|
orderUpdate.order.userVisibleStateLabel |
Deprecato: utilizza lo stato Order Extensions. Etichetta visibile all'utente per lo stato di questo ordine. |
|
orderUpdate.order.buyerInfo |
Informazioni sull'acquirente. |
|
orderUpdate.order.image |
Immagine associata all'ordine. |
|
orderUpdate.order.createTime |
Obbligatorio: data e ora di creazione dell'ordine. Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: |
|
orderUpdate.order.lastUpdateTime |
La data e l'ora dell'ultimo aggiornamento dell'ordine. Obbligatorio per OrderUpdate. Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: |
|
orderUpdate.order.transactionMerchant |
Il commerciante che ha facilitato il pagamento. Questo potrebbe essere diverso da un fornitore a livello di elemento pubblicitario. Esempio: ordine Expedia con elemento pubblicitario di ANA. |
|
orderUpdate.order.contents |
Obbligatorio: i contenuti dell'ordine, che sono un gruppo di elementi pubblicitari. |
|
orderUpdate.order.priceAttributes[] |
Prezzo, sconti, tasse e così via. |
|
orderUpdate.order.followUpActions[] |
Azioni successive a livello di ordine. |
|
orderUpdate.order.paymentData |
Dati relativi al pagamento dell'ordine. |
|
orderUpdate.order.termsOfServiceUrl |
Un link ai termini di servizio applicabili all'ordine/ordine proposto. |
|
orderUpdate.order.note |
Note allegate a un ordine. |
|
orderUpdate.order.promotions[] |
Tutte le promozioni associate a questo ordine. |
|
orderUpdate.order.disclosures[] |
Informative associate a questo ordine. |
|
orderUpdate.order.vertical |
Obsoleto: utilizza i verticali. Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni elementi. Questo verticale deve corrispondere al tipo di verticale a livello di elemento pubblicitario. Valori possibili: Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
|
orderUpdate.updateMask |
Nota: vi sono i seguenti suggerimenti/considerazioni per i seguenti campi speciali: 1. order.last_update_time sarà sempre aggiornato come parte della richiesta di aggiornamento. 2. order.create_time, order.google_order_id e order.merchant_order_id verranno ignorati se forniti come parte di updateMask. Un elenco separato da virgole di nomi completi dei campi. Esempio: |
|
orderUpdate.userNotification |
Se specificato, mostra una notifica all'utente con il titolo e il testo specificati. La specifica di una notifica è un suggerimento per inviare una notifica e non è garantito che venga inviata una notifica. |
|
orderUpdate.reason |
Motivo della modifica o dell'aggiornamento. |
|
Campo di unione verticals . Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni elementi. Questo verticale deve corrispondere al tipo di verticale a livello di elemento pubblicitario. verticals può essere solo uno dei seguenti: |
||
orderUpdate.order.purchase |
Ordine di acquisto |
|
orderUpdate.order.ticket |
Vendita di biglietti |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Order
.
OrderUpdate
Aggiorna un ordine.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Deprecato: utilizza OrderUpdate.update_mask. Se type = SNAPSHOT, OrderUpdate.order deve essere l'intero ordine. Se type = ORDER_STATUS, questa è la modifica dello stato a livello di ordine. Vengono presi in considerazione solo order.last_update_time e questo stato verticale. Nota: type.ORDER_STATUS supporta solo gli aggiornamenti dello stato PurcahaseOrderExtension e non è previsto l'estensione di questo supporto. Consigliamo invece di utilizzare updateMask, poiché è più generico, estendibile e può essere utilizzato per tutti i verticali. |
order |
|
updateMask |
Nota: vi sono i seguenti suggerimenti/considerazioni per i seguenti campi speciali: 1. order.last_update_time sarà sempre aggiornato come parte della richiesta di aggiornamento. 2. order.create_time, order.google_order_id e order.merchant_order_id verranno ignorati se forniti come parte di updateMask. Un elenco separato da virgole di nomi completi dei campi. Esempio: |
userNotification |
Se specificato, mostra una notifica all'utente con il titolo e il testo specificati. La specifica di una notifica è un suggerimento per inviare una notifica e non è garantito che venga inviata una notifica. |
reason |
Motivo della modifica o dell'aggiornamento. |
Tipo
Deprecato: utilizza OrderUpdate.update_mask. Aggiornamenti consentiti per un ordine.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Tipo non specificato. Non deve essere impostato in modo esplicito. |
ORDER_STATUS |
Aggiorna solo lo stato dell'ordine. |
SNAPSHOT |
Aggiorna l'istantanea dell'ordine. |
UserNotification
Notifica utente facoltativa da visualizzare nell'ambito dell'aggiornamento dell'ordine.
Rappresentazione JSON | |
---|---|
{ "title": string, "text": string } |
Campi | |
---|---|
title |
Il titolo della notifica per gli utenti. La lunghezza massima consentita è di 30 caratteri. |
text |
Il contenuto della notifica. La lunghezza massima consentita è 100 caratteri. |