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

della voce come visualizzato 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.

PurchaseItemExtension

Contenuti degli elementi pubblicitari del verticale Acquista.

Rappresentazione JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "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

integer

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.

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.

ItemOption

Rappresenta componenti aggiuntivi o elementi secondari.

Rappresentazione JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "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

integer

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. { "allergen": "peanut" }. 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": integer,
  "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)

e l'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)

accettabile per l'utente.
confirmationCode

string

Codice di conferma per questa prenotazione.
partySize

integer

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

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.