Order

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 (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Campi
googleOrderId

string

ID ordine assegnato da Google.
merchantOrderId

string

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

string

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
(deprecated)

string

Deprecato: utilizza lo stato Order Extensions. Etichetta visibile all'utente per lo stato di questo ordine.
buyerInfo

object (UserInfo)

informazioni sull'acquirente.
image

object (Image)

Immagine associata all'ordine.
createTime

string (Timestamp format)

Obbligatorio: data e ora di creazione dell'ordine.

Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".
lastUpdateTime

string (Timestamp format)

La data e l'ora dell'ultimo aggiornamento dell'ordine. Obbligatorio per OrderUpdate.

Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".
transactionMerchant

object (Merchant)

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

object (Contents)

Obbligatorio: i contenuti dell'ordine, che sono un gruppo di elementi pubblicitari.
priceAttributes[]

object (PriceAttribute)

Prezzo, sconti, tasse e così via.
followUpActions[]

object (Action)

Azioni successive a livello di ordine.
paymentData

object (PaymentData)

Dati relativi al pagamento dell'ordine.
termsOfServiceUrl

string

Un link ai termini di servizio applicabili all'ordine/ordine proposto.
note

string

Note allegate a un ordine.
promotions[]

object (Promotion)

Tutte le promozioni associate a questo ordine.
disclosures[]

object (Disclosure)

Informative associate a questo ordine.
vertical
(deprecated)

object

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: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.
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

object (PurchaseOrderExtension)

Ordine di acquisto
ticket

object (TicketOrderExtension)

Vendita di biglietti

Sommario

Wrapper per gli elementi pubblicitari.

Rappresentazione JSON 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Campi
lineItems[]

object (LineItem)

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 (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Campi
paymentResult

object (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

object (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 result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
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

string

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

string

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 (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Campi
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Le informazioni visualizzate del metodo di pagamento utilizzato per la transazione.
paymentMethodProvenance

enum (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 (PaymentType),
  "paymentMethodDisplayName": string
}
Campi
paymentType

enum (PaymentType)

Il tipo di pagamento.
paymentMethodDisplayName

string

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

string

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 (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Campi
status

enum (PurchaseStatus)

Obbligatorio: stato generale dell'ordine.
userVisibleStatusLabel

string

Etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri.
type

enum (PurchaseType)

Obbligatorio: tipo di acquisto.
returnsInfo

object (PurchaseReturnsInfo)

Informazioni di reso per l'ordine.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informazioni di evasione dell'ordine.
extension

object

Eventuali campi aggiuntivi scambiati tra il commerciante e Google.

Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.
purchaseLocationType

enum (PurchaseLocationType)

Luogo di acquisto (in negozio / online)
errors[]

object (PurchaseError)

(Facoltativo) Errori per cui l'ordine è stato rifiutato.

PurchaseError

Errori per i quali un ordine di acquisto può essere rifiutato.

Rappresentazione JSON 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Campi
type

enum (ErrorType)

Obbligatorio: rappresenta il motivo dettagliato per cui un ordine viene rifiutato dal commerciante.
description

string

Descrizione aggiuntiva dell'errore.
entityId

string

ID entità che corrisponde all'errore. Ad esempio, può corrispondere a LineItemId / ItemOptionId.
updatedPrice

object (PriceAttribute)

Pertinente in caso di tipo di errore PRICE_CHANGED / INCORRECT_PRICE.
availableQuantity

integer

Quantità disponibile ora. Applicabile in caso di AVAILABILITY_CHANGED.

TicketOrderExtension

Ordinare contenuti per ordinazioni di biglietti come film, sport ecc.

Rappresentazione JSON 
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Campi
ticketEvent

object (TicketEvent)

L'evento applicato a tutti i biglietti dell'elemento pubblicitario.

TicketEvent

Rappresenta un singolo evento.

Rappresentazione JSON 
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Campi
type

enum (Type)

Obbligatorio: tipo di biglietto dell'evento, ad esempio film o concerto.
name

string

Obbligatorio: nome dell'evento. Ad esempio, se l'evento è un film, questo deve essere il nome del film.
description

string

una descrizione dell'evento.
url

string

URL delle informazioni sull'evento.
location

object (Location)

Il luogo in cui si svolge l'evento o in cui si trova l'organizzazione.
eventCharacters[]

object (EventCharacter)

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

object (Time)

Ora di inizio
endDate

object (Time)

Ora di fine
doorTime

object (Time)

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 (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Campi
type

enum (Type)

tipo di personaggio dell'evento, ad esempio attore o regista.
name

string

nome del carattere.
image

object (Image)

Le immagini dei personaggi.