Order

Entité de commande. 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 
{
  "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.
}
Champs
googleOrderId

string

ID de commande attribué par Google.

merchantOrderId

string

Obligatoire: ID de commande interne attribué par le marchand. Cet identifiant doit être unique. Il est obligatoire pour toute opération ultérieure de mise à jour de commandes. Cet identifiant peut être défini sur l'ID googleOrderId fourni ou sur toute autre valeur unique. Notez que l'ID présenté aux utilisateurs est "userVisibleOrderId", qui peut être une valeur différente et plus conviviale. La longueur maximale autorisée est de 128 caractères.

userVisibleOrderId

string

ID visible par l'utilisateur qui fait référence à la commande en cours. Cet identifiant doit correspondre à celui affiché pour cette commande dans les autres contextes, y compris sur les sites Web, les applications et les e-mails.

userVisibleStateLabel
(deprecated)

string

Obsolète: utilisez plutôt l'état OrderExtensions. Libellé visible par l'utilisateur indiquant l'état de cette commande.
buyerInfo

object (UserInfo)

Informations sur l'acheteur.

image

object (Image)

Image associée à la commande.

createTime

string (Timestamp format)

(obligatoire) : date et heure de création de la commande.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z"
lastUpdateTime

string (Timestamp format)

Date et heure de la dernière mise à jour de la commande. Obligatoire pour OrderUpdate.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z"
transactionMerchant

object (Merchant)

Marchand ayant facilité le paiement. Il peut être différent de celui d'un fournisseur au niveau de l'élément de campagne. Exemple: Commande Expedia avec une ligne de l'ANA.

contents

object (Contents)

Obligatoire: contenu de la campagne (groupe d'éléments de campagne).

priceAttributes[]

object (PriceAttribute)

Prix, remises, taxes, etc.

followUpActions[]

object (Action)

Actions de suivi au niveau de la commande

paymentData

object (PaymentData)

Données relatives au paiement de la commande.

termsOfServiceUrl

string

Lien vers les conditions d'utilisation qui s'appliquent à la commande/commande proposée.

note

string

Notes associées à un ordre.

promotions[]

object (Promotion)

Toutes les promotions associées à cette commande.

disclosures[]

object (Disclosure)

Divulgation associée à cette ordonnance

vertical
(deprecated)

object

Obsolète: utilisez plutôt des secteurs. Ces propriétés s'appliqueront à tous les éléments de ligne, sauf si elles sont remplacées dans certains éléments de ligne. Ce secteur doit correspondre au type de secteur au niveau de l'élément de campagne. Valeurs possibles: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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. Ces propriétés s'appliqueront à tous les éléments de ligne, sauf si elles sont remplacées dans certains éléments de ligne. Ce secteur doit correspondre au type de secteur au niveau de l'élément de campagne. verticals ne peut être qu'un des éléments suivants :
purchase

object (PurchaseOrderExtension)

Bon de commande

ticket

object (TicketOrderExtension)

Commande de billets

UserInfo

Informations sur l'utilisateur. Il s'agit d'informations sur l'utilisateur associé à une commande.

Représentation JSON 
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Champs
email

string

Adresse e-mail de l'utilisateur (par exemple, janedoe@gmail.com).

firstName

string

Prénom de l'utilisateur.

lastName

string

Nom de l'utilisateur.

displayName

string

Nom à afficher de l'utilisateur, qui peut être différent du prénom ou du nom de famille.

phoneNumbers[]

object (PhoneNumber)

Numéros de téléphone de l'utilisateur.

PhoneNumber

Représentation standard d'un numéro de téléphone.

Représentation JSON 
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Champs
e164PhoneNumber

string

Numéro de téléphone au format E.164, tel que défini dans la recommandation E.164 de l'Union internationale des télécommunications (UIT). Lien wiki: https://en.wikipedia.org/wiki/E.164

extension

string

L'extension n'est pas standardisée dans les recommandations de l'UIT, sauf qu'elle est définie comme une série de nombres d'une longueur maximale de 40 chiffres. Il est défini comme une chaîne pour permettre l'utilisation possible d'un zéro au début de l'extension (les organisations ont une liberté totale de le faire, car aucune norme n'est définie). À l'exception des chiffres, d'autres caractères d'appel tels que "," (indiquant une attente) peut être stockée ici. Par exemple, dans le poste xxx-xxx-xxxx poste 123, "123" est l'extension.

preferredDomesticCarrierCode

string

Code de sélection de l'opérateur à privilégier pour appeler ce numéro de téléphone dans le pays. Cela comprend également les codes qui doivent être composés dans certains pays pour les appels passés depuis une ligne fixe vers un mobile, ou inversement. Par exemple, en Colombie, un "3" doit être composé avant le numéro de téléphone lorsque vous passez un appel depuis un mobile vers un téléphone fixe national, et inversement. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Notez qu'il s'agit de la solution "préférée" ce qui signifie que d'autres codes peuvent également fonctionner.

Image

Une image affichée dans la carte.

Représentation JSON 
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
Champs
url

string

URL source de l'image. Les images peuvent être au format JPG, PNG et GIF (animé ou non). Exemple : https://www.agentx.com/logo.png. Obligatoire.

accessibilityText

string

Description textuelle de l'image à utiliser pour l'accessibilité, par exemple avec des lecteurs d'écran. Obligatoire.

height

number

Hauteur de l'image en pixels. Facultatif.

width

number

Largeur de l'image en pixels. Facultatif.

Marchand

Marchand pour le panier/la commande/l'article.

Représentation JSON 
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Champs
id

string

ID facultatif attribué au marchand, le cas échéant.

name

string

Nom du marchand (par exemple, "Panera Bread").

image

object (Image)

Image associée au marchand.

phoneNumbers[]

object (PhoneNumber)

Numéros de téléphone du marchand.

address

object (Location)

Adresse du marchand.

Lieu

Conteneur qui représente un emplacement.

Représentation JSON 
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Champs
coordinates

object (LatLng)

Coordonnées géographiques Nécessite [DEVICE_PRECISE_LOCATION] Autorisation [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].
formattedAddress

string

Adresse affichée (par exemple, "1600 Amphitheatre Pkwy, Mountain View, CA 94043", États-Unis Nécessite [DEVICE_PRECISE_LOCATION] Autorisation [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].
zipCode

string

Code postal. Nécessite [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] Autorisation [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].
city

string

Ville. Nécessite [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] Autorisation [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].
postalAddress

object (PostalAddress)

Adresse postale. Nécessite [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] Autorisation [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].
name

string

Nom du lieu.

phoneNumber

string

Numéro de téléphone de l'établissement (par exemple, le numéro de téléphone de l'établissement ou le numéro de téléphone du lieu de livraison.

notes

string

Notes sur le lieu.

placeId

string

placeId est utilisé avec l'API Places pour récupérer les détails d'un lieu. Consultez la page https://developers.google.com/places/web-service/place-id.

LatLng

Objet représentant une paire latitude/longitude. Celle-ci est exprimée par une paire de valeurs correspondant aux degrés de latitude et de longitude. Sauf indication contraire, ces valeurs doivent être conformes à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.

Représentation JSON 
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].

longitude

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

PostalAddress

Représente une adresse postale, telles que des adresses de livraison ou de paiement. Les services postaux peuvent effectuer une livraison à cette adresse, boîte postale ou autre. Ce champ n'a pas vocation à modéliser des emplacements géographiques (routes, villes ou montagnes).

Généralement, une adresse est créée via une saisie utilisateur ou lors de l'importation de données existantes, en fonction du type de processus.

Conseils pour la saisie ou la modification d'adresse : utilisez un widget d'adresse compatible i18n, tel que https://github.com/google/libaddressinput. Les utilisateurs ne doivent pas voir d'éléments d'interface utilisateur permettant de saisir ou de modifier des champs en dehors des pays où ce champ est utilisé.

Pour en savoir plus sur l'utilisation de ce schéma, consultez la page https://support.google.com/business/answer/6397478.

Représentation JSON 
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Champs
revision

number

Révision du schéma de PostalAddress. Il doit être défini sur 0, à savoir la dernière révision.

Toutes les nouvelles révisions doivent être rétrocompatibles avec les anciennes révisions.
regionCode

string

Obligatoire. Code pays/région CLDR de l'adresse. Il n'est jamais déduit, et il revient à l'utilisateur de s'assurer que la valeur est correcte. Pour en savoir plus, consultez les pages http://cldr.unicode.org/ et http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemple : "CH" pour la Suisse.

languageCode

string

Facultatif. Code de langue BCP-47 du contenu de cette adresse (s'il est connu). Il s'agit souvent de la langue d'UI du formulaire de saisie. Sinon, il doit correspondre à l'une des langues utilisées dans le pays/la région mentionnés dans l'adresse ou leurs équivalents translittérés. Ce champ peut modifier la mise en forme dans certains pays, mais cela ne risque pas de nuire à l'exactitude des données et n'affectera jamais aucune validation ni aucune opération ne concernant pas la mise en forme.

Si cette valeur est inconnue, vous devez l'omettre (plutôt que de spécifier une valeur par défaut éventuellement incorrecte).

Exemples : "zh-Hant", "ja", "ja-Latn" et "en".
postalCode

string

Facultatif. Code postal de l'adresse. Tous les pays n'utilisent pas ou n'exigent pas de codes postaux, mais lorsqu'ils s'en servent, ils peuvent déclencher une validation supplémentaire avec d'autres parties de l'adresse (par exemple, validation par État/code postal aux États-Unis).

sortingCode

string

Facultatif. Code de tri supplémentaire, spécifique à chaque pays. La plupart des régions ne s'en servent pas. Lorsqu'il est utilisé, sa valeur comprend une chaîne de type CEDEX, éventuellement suivie d'un numéro (par exemple CEDEX 7), ou tout simplement un nombre représentant un "code de secteur" (Jamaïque), un "indicateur de zone de livraison" (Malawi) ou un "indicateur postal" (Côte d'Ivoire, par exemple).

administrativeArea

string

Facultatif. Plus haute subdivision administrative utilisée pour les adresses postales d'un pays ou d'une région. Par exemple, il peut s'agir d'un État, d'une province, d'un oblast ou d'une préfecture. Plus précisément, pour l'Espagne, il s'agit de la province et non de la communauté autonome (par exemple, "Barcelone" et non "Catalogne"). De nombreux pays n'utilisent pas de région administrative dans leurs adresses postales. Par exemple, ce champ doit rester vide en Suisse.

locality

string

Facultatif. Fait généralement référence à la ville de l'adresse. Exemples : une "city" aux États-Unis, une "comune" en Italie, une "post town" au Royaume-Uni. Dans les régions du monde où les localités ne sont pas bien définies ou ne s'intègrent pas bien dans cette structure, laissez le champ de localité vide et utilisez addressLines.

sublocality

string

Facultatif. Sous-localité de l'adresse. Il peut s'agir, par exemple, de quartiers, d'arrondissements ou de districts.

addressLines[]

string

Lignes d'adresse non structurées décrivant les niveaux inférieurs d'une adresse.

Étant donné que les valeurs dans "addressLines" ne contiennent pas d'informations de type et peuvent parfois comprendre plusieurs valeurs dans un seul champ (par exemple, "Austin, TX"), il est important que l'ordre des lignes soit bien clair. L'ordre des lignes d'adresse doit correspondre à l'ordre suivi sur les enveloppes pour le pays/la région de l'adresse. Dans les pays où cet ordre peut varier (par exemple, au Japon), "address_language" est utilisé pour le rendre explicite (par exemple, "ja" pour un ordre décroissant et "ja-Latn" ou "en" pour un ordre croissant). De cette façon, la ligne la plus spécifique d'une adresse peut être sélectionnée en fonction de la langue.

La représentation structurelle minimale autorisée d'une adresse consiste en un code "regionCode" avec toutes les informations restantes placées dans les lignes "adresseLines". Il serait possible de mettre en forme une telle adresse de manière très approximative sans géocodage, mais aucun raisonnement sémantique ne pourrait être réalisé quant à l'un des composants d'adresse avant qu'il n'ait été au moins partiellement résolu.

La création d'une adresse contenant uniquement un code "regionCode" et des lignes "addressLines" suivi d'un géocodage est la méthode recommandée pour gérer les adresses complètement déstructurées (plutôt que de deviner quelles parties de l'adresse sont des localités ou des régions administratives).
recipients[]

string

Facultatif. Destinataire. Ce champ peut, dans certaines circonstances, contenir des informations multilignes. Par exemple, il peut comporter la ligne "chez".

organization

string

Facultatif. Nom de l'entreprise.

Sommaire

Enveloppe pour les éléments de campagne.

Représentation JSON 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Champs
lineItems[]

object (LineItem)

Liste des éléments de campagne. Vous devez renseigner au moins 1 élément line_item, et 50 éléments maximum. Tous les éléments de campagne doivent appartenir au même secteur.

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.)

PriceAttribute

Attribut prix d'une commande ou d'une ligne de commande.

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

enum (Type)

Obligatoire: type d'attribut monétaire.

name

string

Obligatoire: chaîne affichée par l'utilisateur pour l'attribut de prix. Cette information est envoyée et localisée par le marchand.

state

enum (State)

Obligatoire : état du prix (estimation ou réel)

taxIncluded

boolean

Indique si le prix est TTC.

Champ d'union spec. Représente la valeur monétaire ou le pourcentage en millisecondes. spec ne peut être qu'un des éléments suivants :
amount

object (Money)

Montant monétaire.

amountMillipercentage
(deprecated)

number

Spécification de pourcentage, au 1/1 000e de pourcentage. Par exemple, 8,750% est représenté par 8 750, et les pourcentages négatifs représentent un pourcentage de remise. Abandon de ce champ. Vous pouvez envisager d'ajouter de nouveau l'outil lorsqu'un cas d'utilisation solide est requis.

Type

Représente le type d'argent.

Enums
TYPE_UNSPECIFIED Le type n'est pas spécifié, les clients ne devraient pas avoir à le définir explicitement.
REGULAR Prix standard à afficher avant l'application des éventuelles remises, etc.
DISCOUNT À soustraire du sous-total.
TAX À ajouter au sous-total.
DELIVERY À ajouter au sous-total.
SUBTOTAL Sous-total avant ajout de frais.
FEE Frais supplémentaires.
GRATUITY À ajouter au sous-total.
TOTAL Prix de la commande ou de l'élément de campagne affiché.

État

Représente l'état du prix.

Enums
STATE_UNSPECIFIED Non spécifié.
ESTIMATE Le prix n'est qu'une estimation.
ACTUAL Prix réel qui sera facturé à l'utilisateur.

Valeur monétaire

Représente un montant associé à un type de devise.

Représentation JSON 
{
  "currencyCode": string,
  "amountInMicros": string
}
Champs
currencyCode

string

Code de devise à trois lettres défini par la norme ISO 4217.

amountInMicros

string (int64 format)

Montant en micros. Par exemple, ce champ doit être défini sur 1990000 pour 1,99 $.

Action

Action de suivi associée à la campagne ou à l'élément de campagne.

Représentation JSON 
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Champs
type

enum (Type)

Obligatoire: type d'action.

title

string

Titre ou libellé de l'action, présenté à l'utilisateur. La longueur maximale autorisée est de 100 caractères.

openUrlAction

object (OpenUrlAction)

Mesure à prendre.

actionMetadata

object (ActionMetadata)

Métadonnées associées à une action.

Type

Actions de suivi possibles

Enums
TYPE_UNSPECIFIED Action non spécifiée.
VIEW_DETAILS Afficher les détails de la commande
MODIFY Modifier la commande
CANCEL Action d'annulation de la commande.
RETURN Action de retour de la commande.
EXCHANGE Action pour la commande sur la place de marché.
EMAIL

Action sur l'e-mail. Les types EMAIL et CALL sont obsolètes. openUrlAction.url peut être utilisé comme numéro de téléphone ou comme adresse e-mail.
CALL

Action d'appel
REORDER Action de réorganisation.
REVIEW Vérifiez l'action de la commande.
CUSTOMER_SERVICE Contactez le service client.
FIX_ISSUE Redirigez les utilisateurs vers le site ou l'application du marchand pour résoudre le problème.
DIRECTION Lien vers l'itinéraire.

OpenUrlAction

Ouvre l'URL donnée.

Représentation JSON 
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Champs
url

string

Champ d'URL qui peut contenir l'un des éléments suivants: - URL http/https permettant d'ouvrir une application associée à une application ou une page Web

androidApp

object (AndroidApp)

Informations sur l'application Android si l'URL doit être traitée par une application Android.

urlTypeHint

enum (UrlTypeHint)

Indique une indication pour le type d'URL.

AndroidApp

Spécification de l'application Android pour les restrictions de traitement

Représentation JSON 
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Champs
packageName

string

Nom du package Le nom du package doit être spécifié lorsque vous spécifiez Android Fulfillment.

versions[]

object (VersionFilter)

Lorsque plusieurs filtres sont spécifiés, toute correspondance de filtre déclenche l'application.

VersionFilter

Incluez un filtre de version si une ou plusieurs versions spécifiques de l'application sont requises.

Représentation JSON 
{
  "minVersion": number,
  "maxVersion": number
}
Champs
minVersion

number

Code de version minimal ou 0 inclus.

maxVersion

number

Code de version maximal, inclus. La plage prise en compte est [minVersion:maxVersion]. Une plage nulle implique n'importe quelle version. Exemples : Pour ne spécifier qu'une seule version, indiquez [target_version:target_version]. Pour spécifier n'importe quelle version, ne spécifiez pas les valeurs minVersion et maxVersion. Pour spécifier toutes les versions jusqu'à maxVersion, ne spécifiez pas minVersion. Pour spécifier toutes les versions à partir de minVersion, ne spécifiez pas maxVersion.

UrlTypeHint

Différents types d'indications d'URL.

Enums
URL_TYPE_HINT_UNSPECIFIED Non spécifié
AMP_CONTENT URL qui redirige directement vers le contenu AMP ou vers une URL canonique faisant référence à du contenu AMP via <link rel="amphtml">.

ActionMetadata

Métadonnées associées par action.

Représentation JSON 
{
  "expireTime": string
}
Champs
expireTime

string (Timestamp format)

Heure d'expiration de cette action.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z"

Divulgation

Déclaration concernant un produit, un service ou un règlement susceptible d'être présentée à l'utilisateur.

Représentation JSON 
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Champs
title

string

Titre du communiqué. Exemple : "Informations sur la sécurité".

disclosureText

object (DisclosureText)

Contenu du communiqué. Les liens Web sont autorisés.

presentationOptions

object (DisclosurePresentationOptions)

Options de présentation du communiqué.

DisclosureText

Représente un texte brut avec des liens Web.

Représentation JSON 
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Champs
template

string

Texte à afficher, contenant des espaces réservés tels que "{0}" et "{1}" pour chaque lien textuel à insérer. Exemple : "AVERTISSEMENT: Ce produit peut vous exposer à des substances chimiques connues de l'État de Californie pour provoquer le cancer. Pour plus d'informations, accédez à {0}." Le texte de la mention ne doit pas comporter de contenu promotionnel ou de type publicitaire.

DisclosurePresentationOptions

Options de présentation d'une déclaration.

Représentation JSON 
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Champs
presentationRequirement

enum (PresentationRequirement)

Exigence de présentation de la divulgation.

initiallyExpanded

boolean

Indique si le contenu de la déclaration doit être développé initialement. Dans un premier temps, il est réduit par défaut.

PresentationRequirement

Exigence concernant la présentation du communiqué.

Enums
REQUIREMENT_UNSPECIFIED Exigence non spécifiée. Ne doit pas la définir explicitement.
REQUIREMENT_OPTIONAL Cette divulgation est facultative. Elle peut être ignorée si l'appareil ne permet pas d'afficher les mentions légales.
REQUIREMENT_REQUIRED La divulgation est obligatoire. Si l'appareil ne permet pas d'afficher des informations, la conversation est transmise au téléphone.

PurchaseItemExtension

Contenu des lignes de commande du secteur "Achat".

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

number

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.

PurchaseStatus

État d'achat associé à un bon de commande ou à une ligne spécifique.

Enums
PURCHASE_STATUS_UNSPECIFIED État non spécifié.
READY_FOR_PICKUP Prêt pour le retrait.
SHIPPED Expédiée.
DELIVERED Distribué.
OUT_OF_STOCK Non disponible.
IN_PREPARATION "IN_PREPARATION" (EN_PREPARATION) peuvent avoir différentes significations dans différents contextes. Pour la commande FOOD, cela peut indiquer que le repas est en cours de préparation. Pour le commerce de détail, il peut s'agir d'un article en cours de conditionnement.
CREATED La commande est créée.
CONFIRMED Le marchand a confirmé la commande.
REJECTED Le marchand a refusé la commande ou l'article.
RETURNED L'article a été renvoyé par l'utilisateur.
CANCELLED La commande ou l'élément de campagne a été annulé par l'utilisateur.
CHANGE_REQUESTED L'utilisateur a demandé la modification de la commande. L'intégrateur est en train de la traiter. La commande doit passer à un autre état une fois la requête traitée.

PurchaseType

Catégorie d'achat.

Enums
PURCHASE_TYPE_UNSPECIFIED Valeur inconnue.
RETAIL Cela inclut les achats de biens physiques.
FOOD Cela inclut l'achat des commandes de repas.
GROCERY Achat de produits alimentaires.
MOBILE_RECHARGE Achat d'une recharge mobile prépayée.

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.

Unité

Enums
UNIT_UNSPECIFIED Unité non spécifiée.
MILLIGRAM Milligramme.
GRAM Gramme.
KILOGRAM Kilogramme.
OUNCE On ne s'arrête jamais !
POUND Livre.

PurchaseReturnsInfo

Renvoie les informations associées à une campagne ou à une ligne spécifique.

Représentation JSON 
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Champs
isReturnable

boolean

Si la valeur est "true", le renvoi est autorisé.

daysToReturn

number

Le retour est autorisé pendant ce délai.

policyUrl

string

Lien vers les conditions de retour.

PurchaseFulfillmentInfo

Informations de traitement associées à un bon de commande ou à une ligne spécifique.

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

string

Identifiant unique de cette option de service.

fulfillmentType

enum (Type)

Obligatoire: type de traitement.

expectedFulfillmentTime

object (Time)

Fenêtre si une période est spécifiée ou heure d'arrivée prévue si une seule heure est spécifiée. Heure de livraison ou de retrait prévue.

expectedPreparationTime

object (Time)

Fenêtre si une période est spécifiée ou heure d'arrivée prévue si une seule heure est spécifiée. Temps prévu pour préparer la nourriture. De préférence une seule fois.

location

object (Location)

Lieu de retrait ou de livraison.

expireTime

string (Timestamp format)

Heure d'expiration de cette option de traitement.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z"
price

object (PriceAttribute)

Coût de cette option.

fulfillmentContact

object (UserInfo)

Contact de l'utilisateur pour ce traitement.

shippingMethodName

string

Nom du mode de livraison sélectionné par l'utilisateur.

storeCode

string

StoreCode de l'établissement. Exemple: Walmart est le marchand et storeCode est le magasin Walmart où le traitement a eu lieu. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Informations supplémentaires sur le mode de retrait de la commande. Ce champ n'est applicable que lorsque le type de traitement est PICKUP.

Type

Type de traitement.

Enums
TYPE_UNSPECIFIED Type non spécifié
DELIVERY Cette commande sera livrée.
PICKUP Cette commande doit être retirée.

Heure

Construction temporelle représentant l'heure d'un événement à utiliser lors de l'affichage d'une commande auprès de l'utilisateur.

Représentation JSON 
{
  "timeIso8601": string
}
Champs
timeIso8601

string

Représente l'heure d'un événement de commande, telle que l'heure de réservation, l'heure de livraison, etc. Il peut s'agir d'une durée (heure de début et de fin), de la date, de la date et de l'heure, etc. Consultez la page https://en.wikipedia.org/wiki/ISO_8601 pour connaître tous les formats acceptés.

PickupInfo

Détails sur la façon dont une commande est retirée. Il inclut des détails tels que le type de retrait en magasin et des métadonnées supplémentaires associées à chaque type, le cas échéant.

Représentation JSON 
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Champs
pickupType

enum (PickupType)

Méthode de retrait en magasin telle que INSTORE, CURBSIDE, etc.

curbsideInfo

object (CurbsideInfo)

Détails spécifiques aux informations liées au drive. Si pickupType n'est pas "CURBSIDE", ce champ sera ignoré.

checkInInfo[]

object (CheckInInfo)

Liste des différentes méthodes acceptées par le partenaire pour l'enregistrement.

PickupType

Liste des types de retrait acceptés.

Enums
UNSPECIFIED Type de retrait non spécifié.
INSTORE Aller chercher de la nourriture à l'intérieur du restaurant.
CURBSIDE Garez le véhicule à un endroit désigné à l'extérieur du restaurant, où quelqu'un y livrerait de la nourriture.

CurbsideInfo

Détails sur la façon dont les commandes au drive seraient facilitées.

Représentation JSON 
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Champs
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

Les partenaires ont besoin d'informations supplémentaires pour faciliter les commandes de drive. Selon le type de traitement choisi, les informations correspondantes sont recueillies auprès de l'utilisateur.

userVehicle

object (Vehicle)

Informations sur le véhicule de l'utilisateur qui passe la commande.

CurbsideFulfillmentType

Valeurs possibles pour les types de commandes Drive disponibles.

Enums
UNSPECIFIED Type de traitement au drive non spécifié.
VEHICLE_DETAIL Informations sur le véhicule requises pour faciliter le retrait au drive.

Véhicule

Informations sur un véhicule

Représentation JSON 
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Champs
make

string

Marque du véhicule (par exemple, "Honda"). Il est présenté à l'utilisateur et doit être localisé. Obligatoire.

model

string

Modèle du véhicule (par exemple, "Grom"). Il est présenté à l'utilisateur et doit être localisé. Obligatoire.

licensePlate

string

Numéro de plaque d'immatriculation (par exemple, "1ABC234"). Obligatoire.

colorName

string

Nom de la couleur du véhicule, par exemple noir Facultatif.

image

object (Image)

URL d'une photo du véhicule. La photo s'affiche au format 256 x 256 pixels environ. L'image doit être au format jpg ou png. Facultatif.

CheckInInfo

Métadonnées requises par le partenaire pour proposer une méthode d'enregistrement.

Représentation JSON 
{
  "checkInType": enum (CheckInType)
}
Champs
checkInType

enum (CheckInType)

Méthode utilisée pour envoyer les instructions d'enregistrement.

CheckInType

Différentes méthodes utilisées pour envoyer des instructions d'enregistrement.

Enums
CHECK_IN_TYPE_UNSPECIFIED Valeur inconnue.
EMAIL Les informations d'enregistrement seront envoyées par e-mail.
SMS Les informations d'enregistrement seront envoyées par SMS.

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

number

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, { &quot;allergen&quot;: &quot;peanut&quot; }. 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": number,
  "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)

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

userAcceptableTimeRange

object (Time)

Période acceptable pour l'utilisateur.

confirmationCode

string

Code de confirmation de cette réservation.

partySize

number

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

ReservationStatus

État de la réservation.

Enums
RESERVATION_STATUS_UNSPECIFIED État non spécifié.
PENDING La réservation est en attente.
CONFIRMED La réservation est confirmée.
CANCELLED La réservation est annulée par l'utilisateur.
FULFILLED La réservation est effectuée.
CHANGE_REQUESTED Le changement de réservation est demandé
REJECTED La réservation a expiré ou a été refusée par l'intégrateur.

ReservationType

Type de réservation.

Enums
RESERVATION_TYPE_UNSPECIFIED Type non spécifié.
RESTAURANT Réservation au restaurant.
HAIRDRESSER Réservation chez le coiffeur.

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.

PaymentData

Données de paiement liées à une commande.

Représentation JSON 
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Champs
paymentResult

object (PaymentResult)

Résultat du paiement utilisé par l'intégrateur pour finaliser une transaction. Ce champ sera renseigné par Actions on Google si l'expérience de paiement est gérée par Actions-on-Google.

paymentInfo

object (PaymentInfo)

Informations de paiement concernant la commande, permettant une interaction directe avec l'utilisateur.

PaymentResult

Résultat du paiement utilisé par l'intégrateur pour finaliser une transaction.

Représentation 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.
}
Champs
Champ d'union result. Les données de paiement Google ou le mode de paiement du marchand sont fournis. result ne peut être qu'un des éléments suivants :
googlePaymentData

string

Google a fourni les données du mode de paiement. Si votre société de traitement des paiements est répertoriée comme société de traitement des paiements acceptée par Google: https://developers.google.com/pay/api/, cliquez sur le lien afin d'obtenir plus d'informations. Sinon, reportez-vous à la documentation suivante pour en savoir plus sur la charge utile. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Mode de paiement fourni par le marchand/l'action, choisi par l'utilisateur.

PaymentInfo

Informations de paiement concernant la commande en cours de réalisation. Ce proto capture des informations utiles pour les interactions avec l'utilisateur.

Représentation JSON 
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Champs
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Informations à afficher sur le mode de paiement utilisé pour la transaction.

paymentMethodProvenance

enum (PaymentMethodProvenance)

Provenance du mode de paiement utilisé pour la transaction. Il est possible que l'utilisateur ait enregistré le même mode de paiement auprès de Google et du marchand.

PaymentMethodDisplayInfo

Résultat du paiement utilisé par l'intégrateur pour finaliser une transaction.

Représentation JSON 
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Champs
paymentType

enum (PaymentType)

Type de paiement.

paymentMethodDisplayName

string

Nom visible de l'utilisateur pour le mode de paiement. Par exemple, VISA **** 1234 Compte courant **** 5678

paymentMethodVoiceName

string

Nom du mode de paiement à énoncer à voix haute à l'utilisateur pour les appareils dotés de l'Assistant vocal. Par exemple, "visa se terminant par un deux trois quatre" ou "compte courant se terminant par cinq six sept huit". Remarque: Il s'agit de la chaîne à optimisation vocale à utiliser à la place de paymentMethodDisplayName pour les appareils dotés d'un assistant vocal uniquement. Si cette chaîne n'est pas définie, l'utilisateur reçoit la valeur paymentMethodDisplayName.

PaymentType

PaymentType indique le mode de paiement utilisé pour le mode de paiement fourni par le marchand. L'action doit également fournir un nom à afficher pour le mode de paiement.

Enums
PAYMENT_TYPE_UNSPECIFIED Type de paiement non spécifié.
PAYMENT_CARD Une carte de crédit/débit ou une carte prépayée.
BANK Le mode de paiement est un compte bancaire.
LOYALTY_PROGRAM Le mode de paiement est un programme de fidélité.
CASH Le mode de paiement est en espèces.
GIFT_CARD Le mode de paiement est une carte cadeau.
WALLET Portefeuille tiers (Paypal, par exemple)

PaymentMethodProvenance

Représente la provenance du mode de paiement utilisé pour la transaction.

Enums
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED La provenance n'est pas spécifiée.
PAYMENT_METHOD_PROVENANCE_GOOGLE La provenance est Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT La provenance est un marchand.

Promotion

Promotions/offres ajoutées au panier.

Représentation JSON 
{
  "coupon": string
}
Champs
coupon

string

Obligatoire: code promotionnel appliqué à cette offre.

PurchaseOrderExtension

Extension de commande pour le secteur des achats. Ces propriétés s'appliquent à tous les éléments de ligne dans l'ordre, sauf si elles sont remplacées dans un élément de ligne.

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

enum (PurchaseStatus)

Obligatoire: état général de la commande.

userVisibleStatusLabel

string

Libellé/Chaîne visible par l'utilisateur de l'état. La longueur maximale autorisée est de 50 caractères.

type

enum (PurchaseType)

Obligatoire: type d'achat.

returnsInfo

object (PurchaseReturnsInfo)

Informations de retour pour la commande.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informations de traitement de la commande.

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

enum (PurchaseLocationType)

Lieu de l'achat (en magasin / en ligne)

errors[]

object (PurchaseError)

Facultatif: erreurs entraînant le refus de cette commande.

PurchaseLocationType

Type de lieu de l'achat.

Enums
UNSPECIFIED_LOCATION Valeur inconnue.
ONLINE_PURCHASE Tous les achats effectués en ligne.
INSTORE_PURCHASE Tous les achats en magasin.

PurchaseError

Erreurs pour lesquelles un bon de commande peut être refusé.

Représentation JSON 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
Champs
type

enum (ErrorType)

Obligatoire: explique précisément pourquoi une commande est refusée par le marchand.

description

string

Description supplémentaire de l'erreur.

entityId

string

ID d'entité correspondant à l'erreur. Exemple : cela peut correspondre à LineItemId / ItemOptionId.

updatedPrice

object (PriceAttribute)

Pertinent si le type d'erreur est de PRICE_CHANGED / INCORRECT_PRICE.

availableQuantity

number

Quantité disponible. Applicable en cas de AVAILABILITY_CHANGED.

ErrorType

Types d'erreurs possibles.

Enums
ERROR_TYPE_UNSPECIFIED Erreur inconnue
NOT_FOUND L'entité est introuvable. Il pourrait s'agir d'un article, d'un FulfillmentOption ou d'une promotion. Veuillez indiquer un ID d'entité.
INVALID Données d'entité non valides. pourrait être Item, FulfillmentOption, Promotion. Veuillez indiquer un ID d'entité.
AVAILABILITY_CHANGED Article indisponible ou insuffisant pour répondre à la demande. Veuillez indiquer un ID d'entité.
PRICE_CHANGED Prix de l'article différent du prix indiqué dans l'entité "Article". L'ID d'entité et le prix mis à jour sont obligatoires.
INCORRECT_PRICE Erreurs de prix dans les Frais, Total. L'ID d'entité et le prix mis à jour sont obligatoires.
REQUIREMENTS_NOT_MET Contraintes d'acceptation de la commande non respectées - taille minimale du panier, etc.
TOO_LATE FulfillmentOption expiré.
NO_CAPACITY Aucune capacité de service disponible.
INELIGIBLE Utilisateur inéligible à la commande (ajouté à la liste noire).
OUT_OF_SERVICE_AREA Impossible de livrer à l'adresse demandée en raison de règles aux frontières, etc.
CLOSED Le restaurant est fermé au moment de la commande.
PROMO_NOT_APPLICABLE Code d'erreur générique permettant de détecter tous les cas d'échec d'application du code promotionnel, si aucun des cas ci-dessous ne convient. Ajoutez un code promotionnel en tant qu'ID d'entité.
PROMO_NOT_RECOGNIZED Le partenaire n'a pas reconnu le code promotionnel. Ajoutez un code promotionnel en tant qu'ID d'entité.
PROMO_EXPIRED Impossible d'appliquer la promotion, car elle a expiré. Ajoutez un code promotionnel en tant qu'ID d'entité.
PROMO_USER_INELIGIBLE L'utilisateur actuel ne peut pas bénéficier de ce bon de réduction. Ajoutez un code promotionnel en tant qu'ID d'entité.
PROMO_ORDER_INELIGIBLE La commande en cours ne permet pas d'utiliser ce bon de réduction. Ajoutez un code promotionnel en tant qu'ID d'entité.
UNAVAILABLE_SLOT Le créneau pour commander à l'avance n'est pas disponible.
FAILED_PRECONDITION Contraintes d'acceptation de la commande non respectées - taille minimale du panier, etc.
PAYMENT_DECLINED Paiement non valide.
MERCHANT_UNREACHABLE Le marchand n'est pas joignable. Cela peut être utile lorsqu'un partenaire est un agrégateur et qu'il ne parvient pas à contacter le marchand.

TicketOrderExtension

Ordonnez le contenu des billets (films, sports, etc.).

Représentation JSON 
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Champs
ticketEvent

object (TicketEvent)

Événement appliqué à tous les tickets d'éléments de campagne.

TicketEvent

Représente un seul événement.

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

enum (Type)

Obligatoire: type de billet (par exemple, film, concert.

name

string

Obligatoire: nom de l'événement. Par exemple, s'il s'agit d'un film, il doit s'agir du nom du film.

description

string

Description de l'événement.

url

string

URL des informations sur l'événement.

location

object (Location)

Lieu où se déroule l'événement ou où se trouve une organisation.

eventCharacters[]

object (EventCharacter)

Personnages associés à cet événement. Il peut s'agir de réalisateurs ou d'acteurs d'un film, d'artistes de concert, etc.

startDate

object (Time)

Heure de début

endDate

object (Time)

Heure de fin

doorTime

object (Time)

Heure d'entrée, qui peut être différente de l'heure de début de l'événement. Ex. : l'événement commence à 9h, mais l'heure d'entrée est 8h30.

Type

Le type d'événement.

Enums
EVENT_TYPE_UNKNOWN Type d'événement inconnu.
MOVIE Film.
CONCERT Concert.
SPORTS Sports.

EventCharacter

Un caractère d'événement, par exemple organisateur, artiste, etc.

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

enum (Type)

Type du caractère de l'événement (par exemple, un acteur ou un réalisateur.

name

string

Nom du personnage.

image

object (Image)

Images du personnage.

Type

Type de caractère.

Enums
TYPE_UNKNOWN Type inconnu.
ACTOR Acteur.
PERFORMER L'artiste.
DIRECTOR Un réalisateur.
ORGANIZER Organisateur.