LineItem

Un élément de campagne contient un secteur. Une commande ou un panier peut comporter plusieurs lignes du même secteur. Les éléments de sous-lignes, les modules complémentaires, etc. doivent être définis dans des prototypes verticaux en fonction de leurs cas d'utilisation. Remarque: 1. Sauf indication contraire, toutes les chaînes, quel que soit leur niveau, doivent comporter moins de 1 000 caractères. 2. Sauf indication contraire, tous les champs répétés, à tous les niveaux, doivent être inférieurs à 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 les éléments de campagne existants lors de l'application de mises à jour partielles. La longueur maximale autorisée est de 64 caractères.

name

string

Nom de la ligne, 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 vertical. Par exemple, pour les achats, utilisez "PurchaseOrderExtension.status". Libellé visible par l'utilisateur correspondant à 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 commande globale. Exemple: Commande Expedia avec ANA du fournisseur d'éléments de campagne.

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 paramètre peut être différent de celui de l'acheteur au niveau de la commande. Exemple: L'utilisateur X a effectué une réservation au restaurant sous le nom de l'utilisateur Y.

image

object (Image)

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

description

string

Description de l'élément de campagne.

notes[]

string

Remarques supplémentaires applicables à cette ligne spécifique (par exemple, les modalités d'annulation).

disclosures[]

object (Disclosure)

Divulgation associée à 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 détails de traitement des commandes. 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 détails de traitement des commandes. verticals ne peut être qu'un des éléments suivants :
purchase

object (PurchaseItemExtension)

Bons de commande (produits, nourriture, etc.)

reservation

object (ReservationItemExtension)

Commandes pour réservation (restaurant, coupe de cheveux, etc.)

PurchaseItemExtension

Contenu des lignes de commande 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: étiquette/chaîne 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

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

quantity

integer

Quantité de l'article.

unitMeasure

object (MerchantUnitMeasure)

Unité de mesure. Indique la taille de l'article dans les unités choisies. La taille et le prix actif sont utilisés pour déterminer le prix unitaire.

returnsInfo

object (PurchaseReturnsInfo)

Renvoie les informations sur cette ligne. 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 article. Si cette règle n'est pas configurée, cet élément de campagne hérite des informations de traitement au niveau de la commande.

itemOptions[]

object (ItemOption)

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

extension

object

Tout champ supplémentaire échangé 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 sont des articles : code 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 sont 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

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

gtin

string

Code article international (GTIN) du produit. Cette valeur est utile si l'identifiant "offerId" n'est pas présent dans Merchant Center. Facultatif.

plu

string

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

productType

string

Catégorie du produit définie par le marchand. Exemple : Accueil > Courses > Produits laitiers et Œufs > Lait > Lait entier"

productAttributes

map (key: string, value: string)

Informations sur le produit fournies par le marchand (par exemple, { "allergen": "peanut" }. Cette valeur est utile si l'identifiant "offerId" 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 la ligne pour les ordres de réservation (restaurant, coupe de cheveux, 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: étiquette/chaîne visible par l'utilisateur pour l'état. La longueur maximale autorisée est de 50 caractères.

type

enum (ReservationType)

type de réservation. Peut être désactivé si aucune des options de type ne s'applique.

reservationTime

object (Time)

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

userAcceptableTimeRange

object (Time)

une période acceptable pour l'utilisateur.

confirmationCode

string

Code de confirmation de cette réservation.

partySize

integer

Nombre de personnes.

staffFacilitators[]

object (StaffFacilitator)

Des animateurs du personnel qui s'occuperont de la réservation. Ex. : Le coiffeur.

location

object (Location)

Lieu du service/de l'événement.

extension

object

Tout champ supplémentaire échangé 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 le membre des forces armées.

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.