Order

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 (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 potrebbe essere un valore diverso e più intuitivo. 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 l'ID visualizzato per quest'ordine in altri contesti, tra cui siti web, app ed email.
userVisibleStateLabel
(deprecated)

string

Deprecato: utilizza invece 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)

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

object (Contents)

Obbligatorio: ordina i contenuti, ovvero un gruppo di elementi pubblicitari.
priceAttributes[]

object (PriceAttribute)

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

object (Action)

Azioni di follow-up a livello di ordine.
paymentData

object (PaymentData)

Dati relativi al pagamento relativi all'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

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: 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 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

object (PurchaseOrderExtension)

Ordine di acquisto
ticket

object (TicketOrderExtension)

Ordine biglietto

Sommario

Wrapper per gli elementi pubblicitari.

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

object (LineItem)

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

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

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

string

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

string

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

object (PaymentMethodDisplayInfo)

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

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

enum (PaymentType)

Il tipo di pagamento.
paymentMethodDisplayName

string

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

string

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

Le informazioni per il reso dell'ordine.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informazioni di evasione ordine per l'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 a causa dei quali 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 granulare per cui un ordine viene rifiutato dal commerciante.
description

string

Descrizione aggiuntiva dell'errore.
entityId

string

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

object (PriceAttribute)

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

integer

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 (TicketEvent)
  }
}
Campi
ticketEvent

object (TicketEvent)

L'evento applicato a tutti i biglietti degli elementi pubblicitari.

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 un film, un concerto.
name

string

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

string

descrizione dell'evento.
url

string

URL delle informazioni sull'evento.
location

object (Location)

Il luogo in cui si tiene l'evento o il luogo in cui si trova un'organizzazione.
eventCharacters[]

object (EventCharacter)

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

object (Time)

Ora di inizio
endDate

object (Time)

Ora di fine
doorTime

object (Time)

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

enum (Type)

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

string

del carattere.
image

object (Image)

Immagini del personaggio.