- Rappresentazione JSON
- Sommario
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- Promozione
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
Entità dell'ordine. Nota: 1. Se non diversamente specificato, tutte le stringhe a tutti i livelli devono essere inferiori a 1000 caratteri. 2. Se non diversamente specificato, tutti i campi ripetuti a tutti i livelli devono essere inferiori a 50. 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 può essere un valore diverso e più facile da usare. 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 quello visualizzato per questo ordine in altri contesti, tra cui siti web, app ed email. |
|
userVisibleStateLabel |
Deprecato: utilizza 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 |
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. |
|
contents |
Obbligatorio: i contenuti dell'ordine, che sono un gruppo di elementi pubblicitari. |
|
priceAttributes[] |
Prezzo, sconti, tasse e così via. |
|
followUpActions[] |
Azioni successive a livello di ordine. |
|
paymentData |
Dati relativi al pagamento dell'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 |
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 |
|
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: |
||
purchase |
Ordine di acquisto |
|
ticket |
Vendita di biglietti |
Sommario
Wrapper per gli elementi pubblicitari.
Rappresentazione JSON | |
---|---|
{
"lineItems": [
{
object ( |
Campi | |
---|---|
lineItems[] |
Elenco degli elementi pubblicitari dell'ordine. È obbligatorio almeno un elemento pubblicitario, al massimo 50 consentiti. Tutti gli elementi pubblicitari devono appartenere allo stesso verticale. |
PaymentData
Dati di pagamento relativi a un ordine.
Rappresentazione JSON | |
---|---|
{ "paymentResult": { object ( |
Campi | |
---|---|
paymentResult |
Risultato del pagamento utilizzato dall'integratore per completare una transazione. Questo campo verrà compilato da azioni su Google se l'esperienza di pagamento è gestita da actions-on-Google. |
paymentInfo |
Dati di pagamento relativi all'ordine utili per l'interazione rivolta agli utenti. |
PaymentResult
Risultato del pagamento utilizzato dall'integratore per il completamento di una transazione.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo di 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 l'elaboratore dei pagamenti è elencato come elaboratore dei pagamenti supportato da Google qui: https://developers.google.com/pay/api/ accedi a tale elaboratore tramite il link per ulteriori dettagli. In caso contrario, consulta la seguente documentazione per i dettagli del payload. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Metodo di pagamento fornito dal commerciante o 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 del metodo di pagamento utilizzato per la transazione. |
paymentMethodProvenance |
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 del pagamento utilizzato dall'integratore per il completamento di una transazione.
Rappresentazione JSON | |
---|---|
{
"paymentType": enum ( |
Campi | |
---|---|
paymentType |
Il tipo di pagamento. |
paymentMethodDisplayName |
Nome del metodo di pagamento visibile all'utente. Ad esempio: VISA **** 1234 Conto corrente **** 5678 |
Promozione
Promozioni/offerte aggiunte al carrello.
Rappresentazione JSON | |
---|---|
{ "coupon": string } |
Campi | |
---|---|
coupon |
Obbligatorio: codice coupon applicato a questa offerta. |
PurchaseOrderExtension
Estensione di ordine per il verticale di 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 generale dell'ordine. |
userVisibleStatusLabel |
Etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri. |
type |
Obbligatorio: tipo di acquisto. |
returnsInfo |
Informazioni di reso per l'ordine. |
fulfillmentInfo |
Informazioni di evasione dell'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 per cui 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 dettagliato per cui un ordine viene rifiutato dal commerciante. |
description |
Descrizione aggiuntiva dell'errore. |
entityId |
ID entità che corrisponde all'errore. Ad esempio, può corrispondere a LineItemId / ItemOptionId. |
updatedPrice |
Pertinente in caso di tipo di errore PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
Quantità disponibile ora. Applicabile in caso di AVAILABILITY_CHANGED. |
TicketOrderExtension
Ordinare contenuti per ordinazioni di biglietti come film, sport ecc.
Rappresentazione JSON | |
---|---|
{
"ticketEvent": {
object ( |
Campi | |
---|---|
ticketEvent |
L'evento applicato a tutti i biglietti dell'elemento pubblicitario. |
TicketEvent
Rappresenta un singolo evento.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio: tipo di biglietto dell'evento, ad esempio film o concerto. |
name |
Obbligatorio: nome dell'evento. Ad esempio, se l'evento è un film, questo deve essere il nome del film. |
description |
una descrizione dell'evento. |
url |
URL delle informazioni sull'evento. |
location |
Il luogo in cui si svolge l'evento o in cui si trova l'organizzazione. |
eventCharacters[] |
I personaggi relativi a questo evento. Può trattarsi di registi o attori di un evento cinematografico o di artisti di un concerto e così via. |
startDate |
Ora di inizio |
endDate |
Ora di fine |
doorTime |
L'orario di ingresso, che potrebbe essere diverso dall'ora di inizio dell'evento, ad esempio alle 9:00, mentre l'ora di ingresso è alle 08:30. |
EventCharacter
Un personaggio dell'evento, ad esempio organizzatore, esecutore e così via.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
tipo di personaggio dell'evento, ad esempio attore o regista. |
name |
nome del carattere. |
image |
Le immagini dei personaggi. |