LineItem

Un élément de campagne contient un secteur. Une commande ou un panier peut comporter plusieurs articles associés au même secteur. Les éléments de sous-ligne, les modules complémentaires, etc. doivent être définis dans des fichiers proto verticaux en fonction de leurs cas d'utilisation. Remarque: 1. Sauf indication contraire, toutes les chaînes, à tous les niveaux, doivent comporter moins de 1 000 caractères. 2. Sauf indication contraire, le nombre de champs répétés, quel que soit le niveau, doit être inférieur à 50. 3. S'ils sont spécifiés, tous les codes temporels de tous les niveaux doivent être valides.

Représentation 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.
}
Champs
id

string

Obligatoire: identifiant attribué par le marchand pour l'article. Permet d'identifier un élément de campagne existant dans les mises à jour partielles. La longueur maximale autorisée est de 64 caractères.

name

string

le nom de l'élément, tel qu'il apparaît sur le reçu. La longueur maximale autorisée est de 100 caractères.

userVisibleStateLabel
(deprecated)

string

Obsolète. Utilisez plutôt l'état au niveau du secteur. Par exemple, pour les achats, utilisez purchaseOrderExtension.status. Libellé visible par l'utilisateur pour l'état de cet élément de campagne.

provider

object (Merchant)

Fournisseur de l'élément de campagne concerné, s'il est différent de la campagne globale. Exemple: Commande Expedia avec le fournisseur d'éléments de campagne ANA.

priceAttributes[]

object (PriceAttribute)

Prix et ajustements au niveau de l'élément de campagne.

followUpActions[]

object (Action)

Actions de suivi au niveau de l'élément de campagne.

recipients[]

object (UserInfo)

Clients au niveau de l'élément de campagne. Ce champ peut être différent de celui de l'acheteur au niveau de la commande. Exemple: L'utilisateur X a réservé un restaurant sous le nom de l'utilisateur Y.

image

object (Image)

Petite image associée à cet élément, le cas échéant.

description

string

Description de l'élément de campagne.

notes[]

string

Remarques supplémentaires applicables à cet article particulier, par exemple les modalités d'annulation.

disclosures[]

object (Disclosure)

Divulgations associées à cet élément de campagne.

vertical
(deprecated)

object

Obsolète: utilisez plutôt des secteurs. Obligatoire: contenu sémantique de l'élément de campagne en fonction de son type/secteur. Chaque secteur doit inclure ses propres informations de traitement. Doit correspondre à l'une des valeurs suivantes: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

Champ d'union verticals. Obligatoire: contenu sémantique de l'élément de campagne en fonction de son type/secteur. Chaque secteur doit inclure ses propres informations de traitement. verticals ne peut être qu'un des éléments suivants :
purchase

object (PurchaseItemExtension)

Bons de commande, tels que des marchandises, de la nourriture, etc.

reservation

object (ReservationItemExtension)

Commandes de réservation (restaurant, salon de coiffure, etc.)

PurchaseItemExtension

Contenu de l'élément de campagne du secteur "Achat".

Représentation 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)
  }
}
Champs
status

enum (PurchaseStatus)

Obligatoire: état au niveau de l'élément de campagne.

userVisibleStatusLabel

string

Obligatoire: chaîne/libellé visible par l'utilisateur pour l'état. La longueur maximale autorisée est de 50 caractères.

type

enum (PurchaseType)

Obligatoire: type d'achat.

productId
(deprecated)

string

ID du produit ou de l'offre associé à cet élément de campagne.

quantity

integer

Quantité de l'article.

unitMeasure

object (MerchantUnitMeasure)

Mesure unitaire. Spécifie la taille de l'article dans les unités choisies. La taille et le prix en vigueur sont utilisés pour déterminer le prix unitaire.

returnsInfo

object (PurchaseReturnsInfo)

Affiche des informations sur cet élément de campagne. Si cette règle n'est pas configurée, cet élément de campagne hérite des informations sur les retours au niveau de la campagne.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informations de traitement pour cet élément de campagne. Si cette règle n'est pas configurée, cet élément de campagne hérite des informations de traitement au niveau de la campagne.

itemOptions[]

object (ItemOption)

Modules complémentaires ou sous-éléments supplémentaires.

extension

object

Tous les champs supplémentaires échangés entre le marchand et Google.

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

productDetails

object (ProductDetails)

Informations sur le produit.

MerchantUnitMeasure

Mesure de prix unitaire du marchand.

Représentation JSON
{
  "measure": number,
  "unit": enum (Unit)
}
Champs
measure

number

Valeur: exemple 1.2.

unit

enum (Unit)

Unité: exemple POUND, GRAM.

ItemOption

Représente des modules complémentaires ou des sous-éléments.

Représentation JSON
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Champs
id

string

Pour les options qui correspondent à des articles, saisissez un identifiant d'article unique.

name

string

Nom de l'option.

prices[]

object (PriceAttribute)

Prix total de l'option.

note

string

Remarque concernant l'option.

quantity

integer

Pour les options qui incluent des articles, quantité.

productId

string

Identifiant du produit ou de l'offre associé à cette option.

subOptions[]

object (ItemOption)

Pour définir d'autres sous-options imbriquées.

ProductDetails

Informations sur le produit.

Représentation JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Champs
productId

string

ID du produit ou de l'offre associé à cet élément de campagne.

gtin

string

Code article international du produit. Utile si l'identifiant de l'offre n'est pas présent dans Merchant Center. Facultatif.

plu

string

Les codes de recherche de prix, communément appelés codes PLU, PLU, PLU, produits ou étiquettes de produits, sont un système de numéros qui identifient de manière unique les produits vendus en gros vendus dans les épiceries et les supermarchés.

productType

string

Catégorie de produits définie par le marchand. Par exemple, "Accueil > Épicerie > Produits laitiers et œufs > Lait > Lait entier"

productAttributes

map (key: string, value: string)

Informations fournies par le marchand sur le produit, par exemple { "allergen": "peanut" }. Utile si l'identifiant de l'offre n'est pas présent dans Merchant Center. Facultatif.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Contenu de l'élément de campagne pour les commandes de réservation ("restaurant", "coiffeur", etc.). Identifiant suivant: 15.

Représentation 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: ...,
    ...
  }
}
Champs
status

enum (ReservationStatus)

Obligatoire: état de la réservation.

userVisibleStatusLabel

string

Obligatoire: chaîne/libellé visible par l'utilisateur pour l'état. La longueur maximale autorisée est de 50 caractères.

type

enum (ReservationType)

le type de réservation. Peut être désactivé si aucune des options de type n'est applicable.

reservationTime

object (Time)

l'heure à laquelle le service/événement est programmé. Il peut s'agir d'une période, d'une date ou d'une date et d'une heure exactes.

userAcceptableTimeRange

object (Time)

période acceptable pour l'utilisateur.

confirmationCode

string

Code de confirmation pour cette réservation.

partySize

integer

Nombre de personnes.

staffFacilitators[]

object (StaffFacilitator)

Les animateurs de personnel qui se chargeront de la réservation. Ex. : Le coiffeur.

location

object (Location)

Emplacement du service/événement.

extension

object

Tous les champs supplémentaires échangés entre le marchand et Google.

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

StaffFacilitator

Informations sur la personne d'assistance.

Représentation JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
Champs
name

string

Nom de l'animateur du personnel. Ex. : "Jean Dupont"

image

object (Image)

Images de l'artiste.