LineItem

Un elemento pubblicitario contiene un verticale. Un ordine o un carrello può avere più elementi pubblicitari dello stesso verticale. Gli elementi pubblicitari secondari/componenti aggiuntivi devono essere definiti nei prototipi verticali in base ai relativi casi d'uso. 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 
{
  "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: l'identificatore assegnato dal commerciante all'elemento pubblicitario. Utilizzato per identificare gli elementi pubblicitari esistenti nell'applicazione di aggiornamenti parziali. La lunghezza massima consentita è 64 caratteri.
name

string

nome dell'elemento pubblicitario così come appare sulla ricevuta. La lunghezza massima consentita è 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 di uno specifico elemento pubblicitario, se diverso dall'ordine complessivo. Esempio: ordine Expedia con il fornitore dell'elemento pubblicitario ANA.
priceAttributes[]

object (PriceAttribute)

Prezzo e aggiustamenti a livello di elemento pubblicitario.
followUpActions[]

object (Action)

Azioni successive all'elemento pubblicitario.
recipients[]

object (UserInfo)

Clienti a livello di elemento pubblicitario, che potrebbe essere diverso dall'acquirente a livello di ordine. Esempio: l'utente X ha prenotato un ristorante con il nome dell'utente Y.
image

object (Image)

Immagine piccola associata all'elemento, se presente.
description

string

Descrizione dell'elemento pubblicitario.
notes[]

string

Note aggiuntive applicabili a questa particolare voce, ad esempio le norme sulla cancellazione.
disclosures[]

object (Disclosure)

Informative associate a questo elemento pubblicitario.
vertical
(deprecated)

object

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

object (PurchaseItemExtension)

Ordini di acquisto come beni, cibo e così via
reservation

object (ReservationItemExtension)

Ordini di prenotazione come ristorante, taglio di capelli ecc.

PurchaseItemExtension

Contenuti dell'elemento pubblicitario del verticale di acquisto.

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'elemento nelle unità scelte. La dimensione, insieme al prezzo attivo, viene utilizzata 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 per questa voce. Se non viene configurato, questo elemento pubblicitario eredita le informazioni di evasione a livello di ordine.
itemOptions[]

object (ItemOption)

Altri 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 del prezzo per unità 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 che sono articoli, 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

Global Trade Item Number (GTIN) del prodotto. Utile se offerId non è presente in Merchant Center. Campo facoltativo.
plu

string

I codici di ricerca dei prezzi, comunemente denominati codici PLU, numeri PLU, PLU, codici di produzione o etichette di prodotti, sono un sistema di numeri che identifica in modo univoco i prodotti all'ingrosso venduti nei supermercati e nei supermercati.
productType

string

Categoria di prodotto definita dal commerciante. Ad esempio: "Casa > Alimentari > Latticini e uova > Latte > Latte intero"
productAttributes

map (key: string, value: string)

Dettagli sul prodotto forniti dal commerciante, ad esempio { "allergen": "peanut" }. Utile se offerId non è presente in Merchant Center. Campo facoltativo.

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

ReservationItemExtension

Contenuti dell'elemento pubblicitario per ordini di prenotazione come ristorante, taglio di capelli e così via. 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 della 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)

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

object (Time)

accettabile per l'utente.
confirmationCode

string

Codice di conferma della prenotazione.
partySize

integer

Il numero di persone.
staffFacilitators[]

object (StaffFacilitator)

I facilitatori del personale che si occuperanno della prenotazione. Ad es. Il parrucchiere.
location

object (Location)

Luogo del servizio/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 incaricato del servizio.

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

string

Il nome del facilitatore del personale. Ad es. "Mario Rossi"
image

object (Image)

Immagini dell'artista.