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

UserInfo

Informazioni sull'utente. Queste informazioni vengono utilizzate per rappresentare le informazioni dell'utente associate a un ordine.

Rappresentazione JSON
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Campi
email

string

Indirizzo email dell'utente, ad esempio janedoe@gmail.com.

firstName

string

Nome dell'utente.

lastName

string

Cognome dell'utente.

displayName

string

Il nome visualizzato dell'utente, che potrebbe essere diverso dal nome o dal cognome.

phoneNumbers[]

object (PhoneNumber)

Numeri di telefono dell'utente.

Numero di telefono

Rappresentazione standard del numero di telefono.

Rappresentazione JSON
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Campi
e164PhoneNumber

string

Numero di telefono nel formato E.164, come definito nella Raccomandazione dell'Unione internazionale delle telecomunicazioni (ITU) E.164. link wiki: https://en.wikipedia.org/wiki/E.164

extension

string

L'estensione non è standardizzata nei suggerimenti ITU, ad eccezione di una serie di numeri con una lunghezza massima di 40 cifre. È definita come una stringa qui per soddisfare il possibile utilizzo di uno zero iniziale nell'estensione (le organizzazioni hanno totale libertà di farlo, in quanto non esiste uno standard definito). Altri caratteri diversi dai numeri, come "," (che indica un'attesa) potrebbero essere archiviati qui. Ad esempio, nell'estensione xxx-xxx-xxxx 123, "123" è l'estensione.

preferredDomesticCarrierCode

string

Il codice di selezione dell'operatore preferito per chiamare questo numero di telefono nazionale. Sono inclusi anche i codici che devono essere compositi in alcuni paesi per le chiamate da rete fissa a cellulare e viceversa. Ad esempio, in Colombia, un "3" deve essere composto prima del numero di telefono stesso quando si chiama da un cellulare a un telefono fisso nazionale e viceversa. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Tieni presente che questa è la categoria "preferita" il che significa che potrebbero funzionare anche altri codici.

Immagine

Un'immagine visualizzata nella scheda.

Rappresentazione JSON
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
Campi
url

string

L'URL di origine dell'immagine. Le immagini possono essere in formato JPG, PNG e GIF (animate e non animate). Ad esempio,https://www.agentx.com/logo.png. Obbligatorio.

accessibilityText

string

Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad es. screen reader. Obbligatorio.

height

number

L'altezza dell'immagine in pixel. (Facoltativo)

width

number

La larghezza dell'immagine in pixel. (Facoltativo)

Commerciante

Commerciante del carrello/ordine/elemento pubblicitario.

Rappresentazione JSON
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Campi
id

string

ID facoltativo assegnato al commerciante, se presente.

name

string

Il nome del commerciante, ad esempio "Panera".

image

object (Image)

L'immagine associata al commerciante.

phoneNumbers[]

object (PhoneNumber)

Numeri di telefono del commerciante.

address

object (Location)

L'indirizzo del commerciante.

Località

Container che rappresenta una località.

Rappresentazione JSON
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Campi
coordinates

object (LatLng)

Coordinate geografiche. Richiede [DEVICE_PRECISE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

Indirizzo visualizzato, ad es. "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA". Richiede [DEVICE_PRECISE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

zipCode

string

Codice postale. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

city

string

Città. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

postalAddress

object (PostalAddress)

Indirizzo postale. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

name

string

Il nome del luogo.

phoneNumber

string

Numero di telefono della sede, ad es. numero di contatto della sede dell'attività o numero di telefono della sede di consegna.

notes

string

Note sulla posizione.

placeId

string

placeId viene utilizzato con l'API Places per recuperare i dettagli di un luogo. Visita la pagina https://developers.google.com/places/web-service/place-id

LatLng

Un oggetto che rappresenta una coppia latitudine/longitudine. Questo valore è espresso come una coppia di doppi che rappresentano i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, questi dati devono essere conformi allo standard WGS84. I valori devono essere compresi negli intervalli normalizzati.

Rappresentazione JSON
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].

longitude

number

Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

PostalAddress

Rappresenta un indirizzo postale, ad esempio per gli indirizzi di consegna postale o di pagamento. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, una P.O. Box o simile. Non è progettato per creare modelli di località geografiche (strade, città, montagne).

Nell'utilizzo tipico, un indirizzo verrebbe creato tramite l'input dell'utente o importando dati esistenti, a seconda del tipo di processo.

Consigli sull'inserimento / modifica di indirizzi: - Usa un widget degli indirizzi compatibile con i18n, come https://github.com/google/libaddressinput. - Agli utenti non devono essere mostrati elementi di interfaccia utente per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato quel campo.

Per ulteriori indicazioni su come utilizzare questo schema, consulta la pagina: https://support.google.com/business/answer/6397478

Rappresentazione JSON
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Campi
revision

number

La revisione dello schema di PostalAddress. Deve essere impostato su 0, ovvero la revisione più recente.

Tutte le nuove revisioni devono essere compatibili con le versioni precedenti.

regionCode

string

Obbligatorio. Codice regione CLDR del paese o della regione dell'indirizzo. Ciò non viene mai dedotto e spetta all'utente assicurarsi che il valore sia corretto. Per informazioni dettagliate, visita le pagine http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera.

languageCode

string

(Facoltativo) Codice lingua BCP-47 dei contenuti di questo indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di input o dovrebbe corrispondere a una delle lingue utilizzate nell'indirizzo. paese/regione o i loro equivalenti traslitterati. Questo può influenzare la formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai su convalida o altre operazioni correlate alla formattazione.

Se questo valore non è noto, dovrebbe essere omesso (anziché specificare un valore predefinito potenzialmente errato).

Esempi: "zh-Hant", "ja", "ja-Latn", "en".

postalCode

string

(Facoltativo) Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. convalida stato/codice postale negli Stati Uniti).

sortingCode

string

(Facoltativo) Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Dove viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad es. "CEDEX 7") o solo un numero, che rappresenta il "codice di settore" (Giamaica), "indicatore zona di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio).

administrativeArea

string

(Facoltativo) Suddivisione amministrativa di livello più elevato utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. In particolare, per la Spagna si tratta della provincia e non della comunità autonoma (ad es. "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad es. in Svizzera, deve essere lasciato vuoto.

locality

string

(Facoltativo) In genere si riferisce alla porzione di città dell'indirizzo. Esempi: città USA, comune in Italia, città postale nel Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non si adattano bene a questa struttura, lascia il campo della località vuoto e utilizza addressLines.

sublocality

string

(Facoltativo) Quartiere dell'indirizzo. Ad esempio, possono essere quartieri, quartieri e distretti.

addressLines[]

string

Righe di indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo.

Poiché i valori in addressLines non hanno informazioni sul tipo e a volte possono contenere più valori in un singolo campo (ad es. "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe dell'indirizzo deve essere "ordine busta" per il paese o la regione dell'indirizzo. Nei luoghi dove questo valore può variare (ad es. in Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per ordinamenti di grandi dimensioni e "ja-Latn" o "en" per valori di piccole dimensioni). In questo modo, è possibile selezionare la riga più specifica di un indirizzo in base alla lingua.

La rappresentazione strutturale minima consentita di un indirizzo è composta da un regionalCode con tutte le informazioni rimanenti inserite in addressLines. Sarebbe possibile formattare un indirizzo del genere in modo molto approssimativo senza geocodifica, ma non è stato possibile effettuare alcun ragionamento semantico su nessuno dei componenti dell'indirizzo fino a quando non è stato almeno parzialmente risolto.

Creare un indirizzo che contenga solo countryCode e addressLines e poi la geocodifica è il metodo consigliato per gestire indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative).

recipients[]

string

(Facoltativo) Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere "cura di" informazioni.

organization

string

(Facoltativo) Il nome dell'organizzazione all'indirizzo.

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.

LineItem

Un elemento pubblicitario contiene un verticale. Un ordine o un carrello può avere più elementi pubblicitari dello stesso verticale. Gli elementi pubblicitari secondari, i componenti aggiuntivi e così via devono essere definiti in protocolli verticali in base ai relativi casi d'uso. 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
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Campi
id

string

Obbligatorio: identificatore assegnato dal commerciante per l'elemento pubblicitario. Utilizzato per identificare l'elemento pubblicitario esistente nell'applicazione di aggiornamenti parziali. La lunghezza massima consentita è di 64 caratteri.

name

string

Nome della voce così come appare sullo scontrino. La lunghezza massima consentita è di 100 caratteri.

userVisibleStateLabel
(deprecated)

string

Deprecato. Utilizza invece lo stato a livello verticale. Ad esempio, per gli acquisti, utilizza PurchaseOrderextension.status. Etichetta visibile all'utente per lo stato di questo elemento pubblicitario.

provider

object (Merchant)

Il fornitore dell'elemento pubblicitario specifico, se diverso dall'ordine complessivo. Esempio: ordine Expedia con fornitore di elementi pubblicitari ANA.

priceAttributes[]

object (PriceAttribute)

Prezzo e aggiustamenti a livello di elemento pubblicitario.

followUpActions[]

object (Action)

Azioni di follow-up a livello di elemento pubblicitario.

recipients[]

object (UserInfo)

Clienti a livello di elemento pubblicitario, potrebbe essere diverso dall'acquirente a livello di ordine. Esempio: l'utente X ha effettuato una prenotazione al ristorante con il nome dell'utente Y.

image

object (Image)

Piccola immagine associata a questo elemento, se presente.

description

string

Descrizione dell'elemento pubblicitario.

notes[]

string

Note aggiuntive applicabili a questo particolare elemento pubblicitario, ad esempio le norme sull'annullamento.

disclosures[]

object (Disclosure)

Informative associate a questo elemento pubblicitario.

vertical
(deprecated)

object

Deprecato: utilizza i verticali. Obbligatorio: contenuti semantici dell'elemento pubblicitario in base al tipo/verticale. Ogni verticale deve includere i propri dettagli di evasione. Deve essere uno dei seguenti valori: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

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. Obbligatorio: contenuti semantici dell'elemento pubblicitario in base al tipo/verticale. Ogni verticale deve includere i propri dettagli di evasione. verticals può essere solo uno dei seguenti:
purchase

object (PurchaseItemExtension)

Ordini di acquisto come merci, cibo, ecc.

reservation

object (ReservationItemExtension)

Ordini di prenotazione come ristorante, taglio di capelli e così via.

PriceAttribute

Attributo prezzo di un ordine o di un elemento pubblicitario.

Rappresentazione JSON
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
Campi
type

enum (Type)

Obbligatorio: attributo Type of money.

name

string

Obbligatorio: l'utente ha visualizzato la stringa dell'attributo prezzo. Questo viene inviato e localizzato dal commerciante.

state

enum (State)

Obbligatorio: stato del prezzo: stimato ed effettivo.

taxIncluded

boolean

Indica se il prezzo è comprensivo di IVA.

Campo unione spec. Rappresenta l'importo monetario o la percentuale in millisecondi. spec può essere solo uno dei seguenti:
amount

object (Money)

Importo monetario.

amountMillipercentage
(deprecated)

number

La specifica percentuale, a 1/1000 di una percentuale. Ad esempio: 8,750% è rappresentato da 8750, le percentuali negative rappresentano sconti percentuali. Stai ritirando questo campo. Valuta la possibilità di aggiungere di nuovo quando è necessario un caso d'uso concreto.

Tipo

Rappresenta il tipo di denaro.

Enum
TYPE_UNSPECIFIED Il tipo non è specificato. I client non devono impostarlo in modo esplicito.
REGULAR Prezzo visualizzato normale, prima dell'applicazione di eventuali sconti e così via.
DISCOUNT Da sottrarre dal totale parziale.
TAX Da aggiungere al totale parziale.
DELIVERY Da aggiungere al totale parziale.
SUBTOTAL Subtotale prima dell'aggiunta di alcune commissioni.
FEE Qualsiasi tariffa aggiuntiva.
GRATUITY Da aggiungere al totale parziale.
TOTAL È stato visualizzato il prezzo dell'ordine o dell'elemento pubblicitario.

Stato

Rappresenta lo stato del prezzo.

Enum
STATE_UNSPECIFIED Non specificato.
ESTIMATE Il prezzo è solo una stima.
ACTUAL Prezzo effettivo che verrà addebitato all'utente.

Denaro

Rappresenta un importo di denaro con il tipo di valuta.

Rappresentazione JSON
{
  "currencyCode": string,
  "amountInMicros": string
}
Campi
currencyCode

string

Il codice valuta di tre lettere definito in ISO 4217.

amountInMicros

string (int64 format)

Importo in micro. Ad esempio, questo campo deve essere impostato su 1990000 per $1,99.

Azione

Un'azione di follow-up associata all'ordine o all'elemento pubblicitario.

Rappresentazione JSON
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Campi
type

enum (Type)

Obbligatorio: tipo di azione.

title

string

Il titolo o l'etichetta dell'azione, mostrata all'utente. La lunghezza massima consentita è di 100 caratteri.

openUrlAction

object (OpenUrlAction)

Azione da intraprendere.

actionMetadata

object (ActionMetadata)

Metadati associati a un'azione.

Tipo

Possibili azioni di follow-up.

Enum
TYPE_UNSPECIFIED Azione non specificata.
VIEW_DETAILS Visualizza l'azione dei dettagli dell'ordine.
MODIFY Azione di modifica ordine.
CANCEL Azione di annullamento dell'ordine.
RETURN Azione dell'ordine di reso.
EXCHANGE Azione ordine di scambio.
EMAIL

Azione email. I tipi EMAIL e CALL sono stati ritirati. openUrlAction.url può essere utilizzato come numero di telefono o come indirizzo email.

CALL

Richiama azione.

REORDER Riordina l'azione.
REVIEW Rivedi l'azione dell'ordine.
CUSTOMER_SERVICE Contatta l'assistenza clienti.
FIX_ISSUE Indirizza al sito o all'app del commerciante per risolvere il problema.
DIRECTION Link di indicazioni stradali.

OpenUrlAction

Apre l'URL specificato.

Rappresentazione JSON
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Campi
url

string

Il campo url che può essere uno dei seguenti: - URL http/https per l'apertura di un'app collegata all'app o di una pagina web

androidApp

object (AndroidApp)

Informazioni sull'app per Android, se si prevede che l'URL venga soddisfatto da un'app per Android.

urlTypeHint

enum (UrlTypeHint)

Indica un suggerimento per il tipo di URL.

AndroidApp

Specifica dell'app per Android per le limitazioni di evasione degli ordini

Rappresentazione JSON
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Campi
packageName

string

Nome del pacchetto Il nome del pacchetto deve essere specificato durante la specifica di Android Fulfillment.

versions[]

object (VersionFilter)

Quando vengono specificati più filtri, l'app viene attivata da qualsiasi corrispondenza di filtro.

VersionFilter

VersionFilter deve essere incluso se sono necessarie versioni specifiche dell'app.

Rappresentazione JSON
{
  "minVersion": number,
  "maxVersion": number
}
Campi
minVersion

number

Codice di versione minimo o 0, inclusi.

maxVersion

number

Codice di versione massimo incluso. L'intervallo considerato è [minVersion:maxVersion]. Un intervallo nullo implica qualsiasi versione. Esempi: per specificare una singola versione, utilizza [target_version:target_version]. Per specificare qualsiasi versione, lascia minVersion e maxVersion non specificati. Per specificare tutte le versioni fino a maxVersion, lascia minVersion non specificata. Per specificare tutte le versioni di minVersion, lascia maxVersion non specificato.

UrlTypeHint

Diversi tipi di suggerimenti URL.

Enum
URL_TYPE_HINT_UNSPECIFIED Non specificato
AMP_CONTENT URL che indirizza direttamente ai contenuti AMP o a un URL canonico che fa riferimento ai contenuti AMP tramite <link rel="amphtml">.

ActionMetadata

Metadati correlati per azione.

Rappresentazione JSON
{
  "expireTime": string
}
Campi
expireTime

string (Timestamp format)

Data di scadenza dell'azione.

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

Informativa

Un'informativa su prodotti, servizi o norme che può essere presentata all'utente.

Rappresentazione JSON
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Campi
title

string

Titolo dell'informativa. Esempio: "Informazioni sulla sicurezza".

disclosureText

object (DisclosureText)

Contenuto della divulgazione. I link web sono consentiti.

presentationOptions

object (DisclosurePresentationOptions)

Opzioni di presentazione per l'informativa.

DisclosureText

Rappresenta un testo normale con link web.

Rappresentazione JSON
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Campi
template

string

Testo da visualizzare, contenente segnaposto come "{0}" e "{1}" per ogni link di testo da inserire. Esempio: "AVVISO: questo prodotto può esporti a sostanze chimiche che sono note allo stato della California come causa di cancro. Per ulteriori informazioni, visita la pagina {0}." Il testo dell'informativa non deve includere contenuti promozionali o simili a quelli degli annunci.

DisclosurePresentationOptions

Opzioni per la presentazione di un'informativa.

Rappresentazione JSON
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Campi
presentationRequirement

enum (PresentationRequirement)

Requisito di presentazione dell'informativa.

initiallyExpanded

boolean

Indica se i contenuti dell'informativa devono essere inizialmente espansi. Per impostazione predefinita, inizialmente è compresso.

PresentationRequirement

Obbligo di presentazione dell'informativa.

Enum
REQUIREMENT_UNSPECIFIED Requisito non specificato. Non deve essere impostato in modo esplicito.
REQUIREMENT_OPTIONAL L'informativa è facoltativa. Puoi saltare questo passaggio se il dispositivo non supporta la visualizzazione delle informative.
REQUIREMENT_REQUIRED L'informativa è obbligatoria. La conversazione verrà indirizzata al telefono se il dispositivo non supporta la visualizzazione di informative.

PurchaseItemExtension

Contenuti degli elementi pubblicitari del verticale Acquista.

Rappresentazione JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
Campi
status

enum (PurchaseStatus)

Obbligatorio: stato a livello di elemento pubblicitario.

userVisibleStatusLabel

string

Obbligatorio: etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri.

type

enum (PurchaseType)

Obbligatorio: tipo di acquisto.

productId
(deprecated)

string

ID prodotto o offerta associato a questo elemento pubblicitario.

quantity

number

Quantità dell'articolo.

unitMeasure

object (MerchantUnitMeasure)

Unità di misura. Specifica la dimensione dell'articolo nelle unità scelte. La taglia, insieme al prezzo attivo, vengono utilizzati per determinare il prezzo unitario.

returnsInfo

object (PurchaseReturnsInfo)

Restituisce le informazioni per questo elemento pubblicitario. Se il criterio non viene configurato, questo elemento pubblicitario eredita le informazioni sui resi a livello di ordine.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informazioni di evasione ordine per questo elemento pubblicitario. Se il criterio non viene configurato, l'elemento pubblicitario eredita le informazioni di evasione a livello di ordine.

itemOptions[]

object (ItemOption)

Ulteriori componenti aggiuntivi o elementi secondari.

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" }.

productDetails

object (ProductDetails)

Dettagli sul prodotto.

PurchaseStatus

Stato di acquisto associato a un ordine di acquisto o a un determinato elemento pubblicitario.

Enum
PURCHASE_STATUS_UNSPECIFIED Stato non specificato.
READY_FOR_PICKUP Pronto per il ritiro.
SHIPPED Spedito.
DELIVERED Consegnato.
OUT_OF_STOCK Non disponibile.
IN_PREPARATION "IN_PREPARAZIONE" potrebbe avere un significato diverso in un contesto diverso. Per l'ordine CIBO, potrebbe essere il cibo in fase di preparazione. Nel caso della vendita al dettaglio, potrebbe trattarsi di un articolo in fase di confezionamento.
CREATED L'ordine viene creato.
CONFIRMED Il commerciante ha confermato l'ordine.
REJECTED Il commerciante ha rifiutato l'ordine o l'elemento pubblicitario.
RETURNED L'articolo è stato restituito dall'utente.
CANCELLED L'ordine o la voce è stato annullato dall'utente.
CHANGE_REQUESTED L'utente ha richiesto una modifica all'ordine e l'integratore sta elaborando questa modifica. L'ordine deve essere spostato in un altro stato dopo la gestione della richiesta.

PurchaseType

La categoria di acquisto.

Enum
PURCHASE_TYPE_UNSPECIFIED Valore sconosciuto.
RETAIL Sono inclusi gli acquisti come beni fisici.
FOOD Include l'acquisto di ordini di cibo.
GROCERY Acquisto di generi alimentari.
MOBILE_RECHARGE Acquisto di ricariche di dispositivi mobili prepagate.

MerchantUnitMeasure

Misura per il prezzo unitario del commerciante.

Rappresentazione JSON
{
  "measure": number,
  "unit": enum (Unit)
}
Campi
measure

number

Valore: esempio 1.2.

unit

enum (Unit)

Unità: esempio POUND, GRAM.

Unità

Enum
UNIT_UNSPECIFIED Unità non specificata.
MILLIGRAM Milligrammo.
GRAM Nonna
KILOGRAM Chilogrammo.
OUNCE Oncia.
POUND Sterlina.

PurchaseReturnsInfo

Restituisce le informazioni associate a un ordine o a un determinato elemento pubblicitario.

Rappresentazione JSON
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Campi
isReturnable

boolean

Se impostato su true, il ritorno è consentito.

daysToReturn

number

La restituzione è consentita entro questo numero di giorni.

policyUrl

string

Link alle norme sui resi.

PurchaseFulfillmentInfo

Informazioni di evasione associate a un ordine di acquisto o a una determinata voce.

Rappresentazione JSON
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Campi
id

string

Identificatore univoco per questa opzione di servizio.

fulfillmentType

enum (Type)

Obbligatorio: il tipo di completamento.

expectedFulfillmentTime

object (Time)

Una finestra se è specificato un intervallo di tempo o un orario di arrivo stimato se è stato specificato un singolo orario. Orario di consegna o ritiro previsto.

expectedPreparationTime

object (Time)

Una finestra se è specificato un intervallo di tempo o un orario di arrivo stimato se è stato specificato un singolo orario. Tempo previsto per la preparazione del cibo. Preferito una tantum.

location

object (Location)

Località di ritiro o consegna.

expireTime

string (Timestamp format)

Ora di scadenza di questa opzione di evasione degli ordini.

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

price

object (PriceAttribute)

Costo di questa opzione.

fulfillmentContact

object (UserInfo)

Contatto utente per questo fulfillment.

shippingMethodName

string

Nome del metodo di spedizione selezionato dall'utente.

storeCode

string

StoreCode della località. Esempio: Walmart è il commerciante e storeCode è il negozio di Walmart in cui è avvenuta l'evasione dell'ordine. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Ulteriori informazioni su come verrà scelto l'ordine. Questo campo è applicabile solo se il tipo di completamento è PICKUP.

Tipo

Tipo di evasione ordine.

Enum
TYPE_UNSPECIFIED Tipo non specificato.
DELIVERY Questo ordine verrà consegnato.
PICKUP Questo ordine deve essere ritirato.

Ora

Costrutto temporale per rappresentare l'ora di un evento da utilizzare per mostrare un ordine all'utente.

Rappresentazione JSON
{
  "timeIso8601": string
}
Campi
timeIso8601

string

Rappresenta l'ora dell'evento dell'ordine, ad esempio l'ora della prenotazione, i tempi di consegna e così via. Può essere una durata (ora di inizio e di fine), soltanto la data, la data e così via. Consulta la pagina https://en.wikipedia.org/wiki/ISO_8601 per tutti i formati supportati.

PickupInfo

Dettagli su come viene ritirato un ordine. Include dettagli come il tipo di ritiro ed eventuali metadati aggiuntivi allegati a ogni tipo.

Rappresentazione JSON
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Campi
pickupType

enum (PickupType)

Metodo di ritiro, come INSTORE, ALL'ABBONAMENTO ecc.

curbsideInfo

object (CurbsideInfo)

Dettagli specifici delle informazioni all'esterno. Se pickupType non è "CURBSIDE", questo campo verrà ignorato.

checkInInfo[]

object (CheckInInfo)

Elenco dei vari metodi supportati dal partner per il supporto del check-in.

PickupType

Elenco dei tipi di ritiro supportati.

Enum
UNSPECIFIED Tipo di ritiro non specificato.
INSTORE Ritirare il cibo all'interno del ristorante.
CURBSIDE Parcheggia il veicolo in un punto designato fuori dal ristorante dove qualcuno consegna il cibo.

CurbsideInfo

Dettagli su come agevolare l'ordine all'esterno.

Rappresentazione JSON
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Campi
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

I partner hanno bisogno di informazioni aggiuntive per agevolare gli ordini con ritiro all'esterno. A seconda del tipo di completamento scelto, i dettagli corrispondenti verranno raccolti dall'utente.

userVehicle

object (Vehicle)

Dettagli del veicolo dell'utente che effettua l'ordine.

CurbsideFulfillmentType

Possibili valori per i tipi di distribuzione all'esterno.

Enum
UNSPECIFIED Tipo di fulfillment all'esterno non specificato.
VEHICLE_DETAIL Dettagli del veicolo obbligatori per facilitare il ritiro all'esterno.

Veicolo

Dettagli su un veicolo

Rappresentazione JSON
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Campi
make

string

Marca del veicolo (ad es. "Honda"). Viene mostrato all'utente e deve essere localizzato. Obbligatorio.

model

string

Modello del veicolo (ad es. "Grom"). Viene mostrato all'utente e deve essere localizzato. Obbligatorio.

licensePlate

string

Numero di targa del veicolo (ad es. "1ABC234"). Obbligatorio.

colorName

string

Nome del colore del veicolo, ad es. nero Facoltativo.

image

object (Image)

URL a una foto del veicolo. La foto verrà visualizzata a circa 256 x 256 px. Deve essere in formato jpg o png. (Facoltativo)

CheckInInfo

Metadati richiesti dal partner per supportare un metodo di check-in.

Rappresentazione JSON
{
  "checkInType": enum (CheckInType)
}
Campi
checkInType

enum (CheckInType)

Metodo utilizzato per inviare istruzioni per il check-in.

CheckInType

Vari metodi utilizzati per inviare istruzioni per il check-in.

Enum
CHECK_IN_TYPE_UNSPECIFIED Valore sconosciuto.
EMAIL Le informazioni per il check-in verranno inviate via email.
SMS Le informazioni per il check-in verranno inviate via SMS.

ItemOption

Rappresenta componenti aggiuntivi o elementi secondari.

Rappresentazione JSON
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Campi
id

string

Per le opzioni che sono articoli, ID articolo univoco.

name

string

Nome opzione.

prices[]

object (PriceAttribute)

Prezzo totale dell'opzione.

note

string

Nota relativa all'opzione.

quantity

number

Per le opzioni relative agli articoli, alla quantità.

productId

string

ID prodotto o offerta associato a questa opzione.

subOptions[]

object (ItemOption)

Per definire altre opzioni secondarie nidificate.

ProductDetails

Dettagli sul prodotto.

Rappresentazione JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Campi
productId

string

ID prodotto o offerta associato a questo elemento pubblicitario.

gtin

string

Codice Global Trade Item Number (GTIN) del prodotto. Utile se offerId non è presente in Merchant Center. (Facoltativo)

plu

string

I codici di ricerca dei prezzi, comunemente chiamati codici PLU, numeri PLU, PLU, codici di prodotto o etichette di prodotti, sono un sistema di numeri che identificano in modo univoco i prodotti all'ingrosso venduti nei negozi di alimentari e supermercati.

productType

string

Categoria di prodotto definita dal commerciante. Ad es. "Home page > Alimentari > Latticini e Uova > Latte > Latte intero"

productAttributes

map (key: string, value: string)

Dettagli forniti dal commerciante sul prodotto, ad es. { &quot;allergen&quot;: &quot;peanut&quot; }. Utile se offerId non è presente in Merchant Center. (Facoltativo)

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Contenuti delle voci per ordini di prenotazione come ristorante, taglio di capelli ecc. ID successivo: 15.

Rappresentazione JSON
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Campi
status

enum (ReservationStatus)

Obbligatorio: stato di prenotazione.

userVisibleStatusLabel

string

Obbligatorio: etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri.

type

enum (ReservationType)

Tipo di prenotazione. Può essere annullata se nessuna delle opzioni del tipo è applicabile.

reservationTime

object (Time)

Ora in cui è pianificato il servizio/l'evento. Può essere un intervallo di tempo, una data o una data e un'ora esatte.

userAcceptableTimeRange

object (Time)

Intervallo di tempo accettabile per l'utente.

confirmationCode

string

Codice di conferma per questa prenotazione.

partySize

number

Il numero di persone.

staffFacilitators[]

object (StaffFacilitator)

Agevolazioni del personale che si occuperanno della prenotazione. Ad esempio, Il parrucchiere.

location

object (Location)

Luogo del servizio/dell'evento.

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" }.

ReservationStatus

Stato della prenotazione.

Enum
RESERVATION_STATUS_UNSPECIFIED Stato non specificato.
PENDING La prenotazione è in attesa.
CONFIRMED La prenotazione è confermata.
CANCELLED La prenotazione è stata annullata dall'utente.
FULFILLED La prenotazione è stata completata.
CHANGE_REQUESTED È stata richiesta la modifica della prenotazione
REJECTED Prenotazione scaduta o rifiutata dall'integratore.

ReservationType

Tipo di prenotazione.

Enum
RESERVATION_TYPE_UNSPECIFIED Tipo non specificato.
RESTAURANT Prenotazione al ristorante.
HAIRDRESSER Prenotazione per il parrucchiere.

StaffFacilitator

Informazioni sulla persona del servizio.

Rappresentazione JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
Campi
name

string

Il nome del facilitatore del personale. Ad esempio, "Mario Rossi"

image

object (Image)

Immagini dell'artista.

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 da Actions on Google se l'esperienza di pagamento è gestita da Actions-on-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,
  "paymentMethodVoiceName": 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

paymentMethodVoiceName

string

Nome del metodo di pagamento da pronunciare all'utente per i dispositivi con assistente solo vocale. Ad esempio, "visto che termina con uno due tre quattro" o "conto corrente che termina con cinque sei sette otto". Nota: questa è la stringa ottimizzata per la voce da utilizzare al posto di paymentMethodDisplayName per i dispositivi con l'assistente solo vocale. Se questa stringa non viene impostata, all'utente verrà pronunciato il metodo paymentMethodDisplayName.

PaymentType

PaymentType indica la forma di pagamento utilizzata per il metodo di pagamento fornito dal commerciante. L'azione deve anche fornire un nome visualizzato per il metodo di pagamento.

Enum
PAYMENT_TYPE_UNSPECIFIED Tipo di pagamento non specificato.
PAYMENT_CARD Una carta di credito/debito o prepagata.
BANK Il metodo di pagamento è un conto bancario.
LOYALTY_PROGRAM Il metodo di pagamento è un programma fedeltà.
CASH Il metodo di pagamento è in contanti.
GIFT_CARD Il metodo di pagamento è una carta regalo.
WALLET Portafoglio di terze parti, ad es. PayPal

PaymentMethodProvenance

Rappresenta la provenienza del metodo di pagamento utilizzata per la transazione.

Enum
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED La provenienza non è specificata.
PAYMENT_METHOD_PROVENANCE_GOOGLE La provenienza è Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT La provenienza è il commerciante.

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.

PurchaseLocationType

Tipo di località in cui è stato effettuato l'acquisto.

Enum
UNSPECIFIED_LOCATION Valore sconosciuto.
ONLINE_PURCHASE Tutti gli acquisti sono stati acquistati online.
INSTORE_PURCHASE Tutti gli acquisti in negozio.

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": number
}
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

number

Quantità disponibile ora. Applicabile in caso di AVAILABILITY_CHANGED.

ErrorType

Tipi di errori possibili.

Enum
ERROR_TYPE_UNSPECIFIED Errore sconosciuto
NOT_FOUND Entità non trovata, ad esempio Articolo, FulfillmentOption, Promozione. ID entità obbligatorio.
INVALID Dati entità non validi. potrebbe essere Articolo, FulfillmentOption, Promozione. ID entità obbligatorio.
AVAILABILITY_CHANGED Articolo non disponibile o insufficiente per soddisfare la richiesta. ID entità obbligatorio.
PRICE_CHANGED Il prezzo dell'articolo è diverso dal prezzo dell'entità elemento. ID entità e prezzo aggiornato obbligatori.
INCORRECT_PRICE Errori di prezzo in Tariffe, Totale. ID entità e prezzo aggiornato obbligatori.
REQUIREMENTS_NOT_MET Vincoli per l'accettazione dell'ordine non soddisfatti: dimensioni minime del carrello e così via
TOO_LATE FulfillmentOption scaduto.
NO_CAPACITY Nessuna capacità del servizio disponibile.
INELIGIBLE L'utente non è idoneo a effettuare un ordine (nella lista nera).
OUT_OF_SERVICE_AREA Impossibile effettuare il recapito all'indirizzo richiesto a causa di regole di confine e così via.
CLOSED Il ristorante è chiuso per l'attività al momento dell'ordinazione.
PROMO_NOT_APPLICABLE Codice di errore generico per individuare tutti i casi di mancata applicazione del codice promozionale, se nessuno di quelli indicati di seguito è idoneo. Aggiungi un codice promozionale come ID entità.
PROMO_NOT_RECOGNIZED Codice coupon non riconosciuto dal partner. Aggiungi un codice promozionale come ID entità.
PROMO_EXPIRED Impossibile applicare la promozione perché è scaduta. Aggiungi un codice promozionale come ID entità.
PROMO_USER_INELIGIBLE L'utente corrente non è idoneo per questo coupon. Aggiungi un codice promozionale come ID entità.
PROMO_ORDER_INELIGIBLE L'ordine corrente non è idoneo per questo coupon. Aggiungi un codice promozionale come ID entità.
UNAVAILABLE_SLOT Lo slot per ordinare non è disponibile.
FAILED_PRECONDITION Limitazioni per l'accettazione dell'ordine non soddisfatte: dimensioni minime del carrello e così via
PAYMENT_DECLINED Pagamento non valido.
MERCHANT_UNREACHABLE Commerciante non raggiungibile. Ciò è utile quando un partner è un aggregatore e non riesce a contattare il commerciante.

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.

Tipo

Il tipo di evento.

Enum
EVENT_TYPE_UNKNOWN Tipo di evento sconosciuto.
MOVIE Film.
CONCERT Concerto.
SPORTS Sport.

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

Nome del carattere.

image

object (Image)

Immagini del personaggio.

Tipo

Tipo di carattere.

Enum
TYPE_UNKNOWN Tipo sconosciuto.
ACTOR Attore.
PERFORMER Artista.
DIRECTOR Regista.
ORGANIZER Organizzatore.