- Rappresentazione JSON
- Sommario
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- Promozione
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
Entità ordine. Nota: 1. Se non diversamente specificato, tutte le stringhe a tutti i livelli devono avere una lunghezza inferiore a 1000 caratteri. 2. Tutti i campi ripetuti a tutti i livelli devono essere inferiori a 50, se non diversamente specificato. 3. Tutti i timestamp a tutti i livelli, se specificati, devono essere timestamp validi.
Rappresentazione JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Campi | ||
---|---|---|
googleOrderId |
ID ordine assegnato da Google. |
|
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 potrebbe essere un valore diverso e più intuitivo. La lunghezza massima consentita è di 128 caratteri. |
|
userVisibleOrderId |
L'ID rivolto all'utente che fa riferimento all'ordine corrente. Questo ID deve essere coerente con l'ID visualizzato per quest'ordine in altri contesti, tra cui siti web, app ed email. |
|
userVisibleStateLabel |
Deprecato: utilizza invece lo stato Order Extensions. Etichetta visibile all'utente per lo stato di questo ordine. |
|
buyerInfo |
informazioni sull'acquirente. |
|
image |
Immagine associata all'ordine. |
|
createTime |
Obbligatorio: data e ora di creazione dell'ordine. Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: |
|
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: |
|
transactionMerchant |
Commerciante che ha facilitato il pagamento. Potrebbe essere diverso da un fornitore a livello di elemento pubblicitario. Esempio: ordine Expedia con elemento pubblicitario proveniente da ANA. |
|
contents |
Obbligatorio: ordina i contenuti, ovvero un gruppo di elementi pubblicitari. |
|
priceAttributes[] |
Prezzo, sconti, tasse e così via. |
|
followUpActions[] |
Azioni di follow-up a livello di ordine. |
|
paymentData |
Dati relativi al pagamento relativi all'ordine. |
|
termsOfServiceUrl |
Un link ai Termini di servizio applicabili all'ordine/ordine proposto. |
|
note |
Note allegate a un ordine. |
|
promotions[] |
Tutte le promozioni associate a questo ordine. |
|
disclosures[] |
Informative associate a questo ordine. |
|
vertical |
Deprecato: utilizza i verticali. Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni. 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 |
|
Campo unione verticals . Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni. Questo verticale deve corrispondere al tipo di verticale a livello di elemento pubblicitario. verticals può essere solo uno dei seguenti: |
||
purchase |
Ordine di acquisto |
|
ticket |
Ordine biglietto |
Sommario
Wrapper per gli elementi pubblicitari.
Rappresentazione JSON | |
---|---|
{
"lineItems": [
{
object ( |
Campi | |
---|---|
lineItems[] |
Elenco degli elementi pubblicitari dell'ordine. È richiesto almeno un elemento pubblicitario, ma ne sono consentiti al massimo 50. Tutti gli elementi pubblicitari devono appartenere allo stesso verticale. |
PaymentData
Dati di pagamento relativi a un ordine.
Rappresentazione JSON | |
---|---|
{ "paymentResult": { object ( |
Campi | |
---|---|
paymentResult |
Risultato di pagamento utilizzato dall'integratore per completare una transazione. Questo campo verrà compilato dalle azioni su Google se l'esperienza di pagamento è gestita da azioni su Google. |
paymentInfo |
Dati di pagamento relativi all'ordine utili per l'interazione con l'utente. |
PaymentResult
Risultato di pagamento utilizzato dall'integratore per completare una transazione.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo unione result . Vengono forniti i dati di pagamento di Google o il metodo di pagamento del commerciante. result può essere solo uno dei seguenti: |
||
googlePaymentData |
Dati del metodo di pagamento forniti da Google. Se il tuo elaboratore dei pagamenti è indicato come elaboratore dei pagamenti supportato da Google, consulta la pagina https://developers.google.com/pay/api/. Per ulteriori dettagli, accedi al tuo elaboratore dei pagamenti tramite il link. In caso contrario, consulta la seguente documentazione per i dettagli sul payload. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Metodo di pagamento fornito dal commerciante/dall'azione scelto dall'utente. |
PaymentInfo
Dati di pagamento relativi all'ordine effettuato. Questo protocollo acquisisce informazioni utili per l'interazione rivolta agli utenti.
Rappresentazione JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Campi | |
---|---|
paymentMethodDisplayInfo |
Le informazioni visualizzate sul metodo di pagamento utilizzato per la transazione. |
paymentMethodProvenance |
La provenienza del metodo di pagamento utilizzato per la transazione. L'utente potrebbe aver registrato lo stesso metodo di pagamento sia con Google sia con il commerciante. |
PaymentMethodDisplayInfo
Risultato di pagamento utilizzato dall'integratore per completare una transazione.
Rappresentazione JSON | |
---|---|
{
"paymentType": enum ( |
Campi | |
---|---|
paymentType |
Il tipo di pagamento. |
paymentMethodDisplayName |
Nome visibile all'utente del metodo di pagamento. Ad esempio, VISA **** 1234 Saving acct **** 5678 |
Promozione
Promozioni/offerte aggiunte al carrello.
Rappresentazione JSON | |
---|---|
{ "coupon": string } |
Campi | |
---|---|
coupon |
Obbligatorio: codice coupon applicato a questa offerta. |
PurchaseOrderExtension
Estensione dell'ordine per il verticale Acquisto. Queste proprietà sono applicabili a tutti gli elementi pubblicitari all'interno dell'ordine, a meno che non vengano sostituite in un elemento pubblicitario.
Rappresentazione JSON | |
---|---|
{ "status": enum ( |
Campi | |
---|---|
status |
Obbligatorio: stato complessivo dell'ordine. |
userVisibleStatusLabel |
Etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri. |
type |
Obbligatorio: tipo di acquisto. |
returnsInfo |
Le informazioni per il reso dell'ordine. |
fulfillmentInfo |
Informazioni di evasione ordine per l'ordine. |
extension |
Eventuali campi aggiuntivi scambiati tra il commerciante e Google. Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
purchaseLocationType |
Luogo di acquisto (in negozio / online) |
errors[] |
(Facoltativo) Errori a causa dei quali l'ordine è stato rifiutato. |
PurchaseError
Errori per i quali un ordine di acquisto può essere rifiutato.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio: rappresenta il motivo granulare per cui un ordine viene rifiutato dal commerciante. |
description |
Descrizione aggiuntiva dell'errore. |
entityId |
L'ID entità corrispondente all'errore. Ad esempio, può corrispondere a LineItemId / ItemOptionId. |
updatedPrice |
Rilevante in caso di tipo di errore PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
Quantità disponibile ora. Applicabile in caso di AVAILABILITY_CHANGED. |
TicketOrderExtension
Contenuti degli ordini di biglietti come film, eventi sportivi e così via
Rappresentazione JSON | |
---|---|
{
"ticketEvent": {
object ( |
Campi | |
---|---|
ticketEvent |
L'evento applicato a tutti i biglietti degli elementi pubblicitari. |
TicketEvent
Rappresenta un singolo evento.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio: tipo di biglietto dell'evento, ad esempio un film, un concerto. |
name |
Obbligatorio: nome dell'evento. Ad esempio, se l'evento è un film, dovrebbe essere il nome del film. |
description |
descrizione dell'evento. |
url |
URL delle informazioni sull'evento. |
location |
Il luogo in cui si tiene l'evento o il luogo in cui si trova un'organizzazione. |
eventCharacters[] |
I caratteri correlati a questo evento. Può trattarsi dei registi o degli attori di un evento cinematografico, degli artisti di un concerto e così via. |
startDate |
Ora di inizio |
endDate |
Ora di fine |
doorTime |
L'ora di ingresso, che potrebbe essere diversa dall'ora di inizio dell'evento. ad es. l’evento inizierà alle 9, ma l’ingresso è alle 8:30. |
EventCharacter
Un carattere evento, ad esempio organizzatore, artista ecc.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
tipo di carattere dell'evento, ad esempio attore o regista. |
name |
del carattere. |
image |
Immagini del personaggio. |