Package google.shopping.merchant.products.v1beta

Index

ProductInputsService

Service permettant d'utiliser la ressource ProductInput. Ce service n'est disponible que pour les produits associés à un canal en ligne.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Supprime un produit saisi de votre compte Merchant Center.

Après l'insertion, la mise à jour ou la suppression d'un produit saisi, plusieurs minutes peuvent s'écouler avant que le produit traité ne puisse être récupéré.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Importe des données produit dans votre compte Merchant Center. Si une entrée associée aux mêmes valeurs contentLanguage, offerId et dataSource existe déjà, cette méthode la remplace.

Après l'insertion, la mise à jour ou la suppression d'un produit saisi, plusieurs minutes peuvent s'écouler avant que le produit traité ne puisse être récupéré.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ProductsService

Service permettant d'utiliser la ressource Product. Ce service n'est disponible que pour les produits associés à un canal en ligne.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Récupère le produit traité à partir de votre compte Merchant Center.

Après l'insertion, la mise à jour ou la suppression d'un produit, plusieurs minutes peuvent s'écouler avant que le produit final mis à jour puisse être récupéré.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Répertorie les produits traités dans votre compte Merchant Center. La réponse peut contenir moins d'éléments que spécifié par pageSize. Appuyez-vous sur pageToken pour déterminer s'il y a d'autres éléments à demander.

Après l'insertion, la mise à jour ou la suppression d'une entrée produit, plusieurs minutes peuvent s'écouler avant que le produit traité mis à jour puisse être récupéré.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

Attributs

Attributs.

Champs
expiration_date

Timestamp

Date d'expiration de l'article, telle que spécifiée lors de l'insertion, au format ISO 8601. La date d'expiration réelle est affichée dans productstatuses en tant que googleExpirationDate. Elle peut être antérieure si expirationDate est trop éloigné.
disclosure_date

Timestamp

Date à laquelle une offre apparaît dans les résultats de recherche des plates-formes YouTube de Google, au format ISO 8601. Pour en savoir plus, consultez la page [Date de divulgation]( https://support.google.com/merchants/answer/13034208).
availability_date

Timestamp

Le jour où un produit précommandé pourra être expédié, au format ISO 8601.
price

Price

Prix de l'article
installment

Installment

Nombre et montant des versements à payer pour l'achat d'un article.
subscription_cost

SubscriptionCost

Nombre de périodes (mois ou années) et montant de paiement par période pour un article associé à un contrat d'abonnement.
loyalty_points

LoyaltyPoints

Points de fidélité accordés aux utilisateurs après avoir acheté l'article. Japon uniquement.
loyalty_programs[]

LoyaltyProgram

Liste d'informations sur le programme de fidélité utilisée pour présenter les avantages fidélité (par exemple, meilleurs prix, points, etc.) à l'utilisateur de cet article.
product_types[]

string

Catégories de l'article (formatées selon les spécifications des données produit).
sale_price

Price

Prix soldé annoncé de l'article.
sale_price_effective_date

Interval

Période au cours de laquelle l'article est soldé (voir les spécifications des données produit).
product_height

ProductDimension

Hauteur du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus).
product_length

ProductDimension

Longueur du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus).
product_width

ProductDimension

Largeur du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus).
product_weight

ProductWeight

Poids du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 2 000 (inclus).
shipping[]

Shipping

Règles de livraison.
free_shipping_threshold[]

FreeShippingThreshold

Conditions à remplir pour qu'un produit puisse bénéficier de la livraison sans frais.
shipping_weight

ShippingWeight

Poids de l'article pour la livraison.
shipping_length

ShippingDimension

Longueur de l'article pour la livraison.
shipping_width

ShippingDimension

Largeur de l'article pour la livraison.
shipping_height

ShippingDimension

Hauteur de l'article pour la livraison.
size_types[]

string

Coupe de l'article. Il peut être utilisé pour représenter des types de coupe combinés pour les articles vestimentaires. Vous pouvez indiquer deux types de coupe au maximum (voir [https://support.google.com/merchants/answer/6324497](type de coupe)).
taxes[]

Tax

Informations fiscales.
unit_pricing_measure

UnitPricingMeasure

Mesure et dimension d'un article.
unit_pricing_base_measure

UnitPricingBaseMeasure

Dénominateur à utiliser pour le prix unitaire.
ads_labels[]

string

Semblable à ads_grouping, mais ne fonctionne que sur le CPC.
cost_of_goods_sold

Price

Prix de revient Utilisé pour les rapports sur la marge brute.
product_details[]

ProductDetail

Spécifications techniques ou informations supplémentaires sur le produit
product_highlights[]

string

Puces décrivant les points forts les plus pertinents d'un produit.
display_ads_similar_ids[]

string

Recommandations spécifiées par l'annonceur.
promotion_ids[]

string

Identifiant unique associé à une promotion.
included_destinations[]

string

Liste des destinations à inclure pour cette cible (correspond aux cases cochées dans Merchant Center) Les destinations par défaut sont toujours incluses, sauf si elles sont fournies dans excludedDestinations.
excluded_destinations[]

string

Liste des destinations à exclure pour cette cible (correspond aux cases cochées dans Merchant Center).
shopping_ads_excluded_countries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) à utiliser pour exclure l'offre de la destination Annonces Shopping. Les pays de cette liste sont supprimés des pays configurés dans les paramètres de la source de données.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

Champs supplémentaires à exporter vers le programme Cloud Retail.
certifications[]

Certification

Certifications de produits, par exemple pour l'étiquetage énergétique des produits enregistrés dans la base de données EPREL de l'UE Pour en savoir plus, consultez l'article du Centre d'aide.
auto_pricing_min_price

Price

Une protection dans les projets "Remises automatiques" (https://support.google.com/merchants/answer/10295759) et "Promotions dynamiques" (https://support.google.com/merchants/answer/13949249) permet de s'assurer que les remises proposées sur les offres des marchands ne sont pas inférieures à cette valeur, et préservent ainsi la valeur et la rentabilité de l'offre.
identifier_exists

bool

Définissez cette valeur sur "false" si l'article ne dispose pas de codes produit uniques adaptés à sa catégorie (code GTIN, référence fabricant et marque, par exemple). Si aucune valeur n'est fournie, la valeur par défaut est "true".
is_bundle

bool

Indique si l'article est un lot défini par le marchand. Un lot est un groupe personnalisé de différents produits vendus par un marchand à un prix unique.
title

string

Titre de l'article.
description

string

Description de l'article.
adult

bool

Défini sur "true" si l'article est destiné aux adultes.
age_group

string

Tranche d'âge cible de l'article.
availability

string

Disponibilité de l'article.
brand

string

Marque de l'article.
color

string

Couleur de l'article.
condition

string

Condition ou état de l'article.
gender

string

Genre ciblé de l'article
google_product_category

string

Catégorie Google de l'article (voir la classification des produits Google). Lorsque vous interrogez des produits, ce champ contient la valeur fournie par l'utilisateur. Il n'existe actuellement aucun moyen de récupérer les catégories de produits Google attribuées automatiquement via l'API.
gtin

string

Code article international (code GTIN) de l'article.
item_group_id

string

Identifiant partagé pour toutes les variantes d'un même produit.
material

string

Matière de l'article.
mpn

string

Référence fabricant (MPN) de l'article.
pattern

string

Motif de l'article (par exemple, à pois).
sell_on_google_quantity

int64

La quantité du produit disponible à la vente sur Google. Disponible uniquement pour les produits en ligne.
max_handling_time

int64

Temps de traitement maximal du produit (en jours ouvrés).
min_handling_time

int64

Temps de traitement minimal du produit (en jours ouvrés).
shipping_label

string

Étiquette de livraison du produit, utilisée pour regrouper le produit dans les règles de livraison au niveau du compte.
transit_time_label

string

Libellé du délai d'acheminement du produit, utilisé pour regrouper le produit dans les tableaux de délais d'acheminement au niveau du compte.
size

string

Taille de l'article. Une seule valeur est autorisée. Pour les variantes de tailles différentes, insérez un produit distinct pour chaque taille avec la même valeur itemGroupId (voir la page [https://support.google.com/merchants/answer/6324492](définition de la taille)).
size_system

string

Système dans lequel la taille est spécifiée. Recommandé pour les articles vestimentaires.
tax_category

string

Catégorie de taxe du produit, utilisée pour configurer un nexus de taxe détaillé dans les paramètres de taxes au niveau du compte.
energy_efficiency_class

string

Classe énergétique telle que définie dans la directive 2010/30/UE de l'UE.
min_energy_efficiency_class

string

Classe énergétique telle que définie dans la directive 2010/30/UE de l'UE.
max_energy_efficiency_class

string

Classe énergétique telle que définie dans la directive 2010/30/UE de l'UE.
multipack

int64

Nombre de produits identiques dans un multipack défini par le marchand.
ads_grouping

string

Permet de regrouper des éléments de manière arbitraire. Uniquement pour le pourcentage de CPA (déconseillé dans le cas contraire).
ads_redirect

string

Permet aux annonceurs de remplacer l'URL de l'article lorsque le produit est affiché dans le contexte d'annonces pour un produit.
display_ads_id

string

Identifiant d'un article pour les campagnes de remarketing dynamique.
display_ads_title

string

Titre d'un article pour les campagnes de remarketing dynamique.
display_ads_value

double

Marge de l'offre pour les campagnes de remarketing dynamique.
pickup_method

string

Option de retrait de l'article.
pickup_sla

string

Chronologie du retrait en magasin pour l'article.
custom_label_0

string

Étiquette personnalisée 0 pour un regroupement personnalisé d'articles dans une campagne Shopping.
custom_label_1

string

Étiquette personnalisée 1 pour un regroupement personnalisé d'articles dans une campagne Shopping.
custom_label_2

string

Étiquette personnalisée 2 pour un regroupement personnalisé d'articles dans une campagne Shopping.
custom_label_3

string

Étiquette personnalisée 3 pour un regroupement personnalisé d'articles dans une campagne Shopping.
custom_label_4

string

Étiquette personnalisée 4 pour un regroupement personnalisé d'articles dans une campagne Shopping.
external_seller_id

string

Obligatoire pour les comptes multivendeurs. Utilisez cet attribut si vous représentez une place de marché qui importe des produits pour différents vendeurs dans votre compte multivendeur.
pause

string

La publication de cet élément sera temporairement suspendue.
structured_title

ProductStructuredTitle

Titre structuré, pour les titres générés par des algorithmes (IA).
structured_description

ProductStructuredDescription

Description structurée pour les descriptions générées par des algorithmes (IA).

Certification

La certification de produit, initialement introduite pour assurer la conformité avec l'étiquetage énergétique de l'UE à l'aide de la base de données EPREL de l'UE.

Champs
certification_authority

string

L'autorité de certification (par exemple, "European_Commission"). Ne doit pas dépasser 2 000 caractères
certification_name

string

Nom de la certification, par exemple "EPREL". Ne doit pas dépasser 2 000 caractères
certification_code

string

Le code de la certification. Ne doit pas dépasser 2 000 caractères
certification_value

string

Valeur de la certification (également appelée "classe", "niveau" ou "note"), par exemple "A+", "C" ou "or". Ne doit pas dépasser 2 000 caractères

CloudExportAdditionalProperties

Propriété de produit de l'API Cloud Retail. Par exemple, les propriétés d'un produit TV peuvent être "Résolution d'écran" ou "Taille d'écran".

Champs
text_value[]

string

Valeur textuelle de la propriété donnée. Par exemple, "8K(UHD)" peut être une valeur textuelle pour un produit TV. Le nombre maximal de répétitions pour cette valeur est de 400. Les valeurs sont stockées dans un ordre arbitraire, mais cohérent. La chaîne ne doit pas dépasser 256 caractères.
int_value[]

int64

Valeurs entières de la propriété donnée. Par exemple, 1080 pour la résolution d'écran d'un produit TV. Le nombre maximal de répétitions pour cette valeur est de 400. Les valeurs sont stockées dans un ordre arbitraire, mais cohérent.
float_value[]

float

Valeurs flottantes de la propriété donnée. Par exemple, pour un produit TV 1.2345. Le nombre maximal de répétitions pour cette valeur est de 400. Les valeurs sont stockées dans un ordre arbitraire, mais cohérent.
property_name

string

Nom de la propriété donnée. Par exemple, "Résolution d'écran" pour un téléviseur. La chaîne ne doit pas dépasser 256 caractères.
bool_value

bool

Valeur booléenne de la propriété donnée. Par exemple, pour un produit TV, indiquez "True" ou "False" si l'écran est en UHD.
min_value

float

Valeur flottante minimale de la propriété donnée. Par exemple, pour un produit TV 1.00.
max_value

float

Valeur flottante maximale de la propriété donnée. Par exemple, pour un produit TV 100.00.
unit_code

string

Unité de la propriété donnée. Par exemple, "Pixels" pour un téléviseur. La taille de chaîne maximale est de 256 octets.

DeleteProductInputRequest

Message de requête pour la méthode DeleteProductInput.

Champs
name

string

Obligatoire. Nom de la ressource d'entrée de produit à supprimer. Format: accounts/{account}/productInputs/{product}
data_source

string

Obligatoire. Source de données principale ou supplémentaire à partir de laquelle les données sur le produit doivent être supprimées. Format : accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Conditions à remplir pour qu'un produit puisse bénéficier de la livraison sans frais.

Champs
country

string

Code CLDR du pays de livraison de l'article.
price_threshold

Price

Prix minimal du produit pour rendre les frais de port sans frais. Représenté par un nombre.

GetProductRequest

Message de requête pour la méthode GetProduct.

Champs
name

string

Obligatoire. Nom du produit à récupérer. Format : accounts/{account}/products/{product}

InsertProductInputRequest

Message de requête pour la méthode InsertProductInput.

Champs
parent

string

Obligatoire. Compte dans lequel ce produit sera inséré. Format: accounts/{account}
product_input

ProductInput

Obligatoire. Entrée de produit à insérer.
data_source

string

Obligatoire. Nom de la source de données produit principale ou supplémentaire. Si le produit existe déjà et que la source de données fournie est différente, il est déplacé vers une nouvelle source de données. Format : accounts/{account}/dataSources/{datasource}.

Versement

Message représentant le versement.

Champs
months

int64

Nombre de versements que l'acheteur doit effectuer.
amount

Price

Montant que l'acheteur doit verser tous les mois.
downpayment

Price

Montant du paiement initial que l'acheteur doit régler.
credit_type

string

Type de versement. Les valeurs acceptées sont les suivantes: * "finance" * "lease"

ListProductsRequest

Message de requête pour la méthode ListProducts.

Champs
parent

string

Obligatoire. Compte pour lequel répertorier les produits traités. Format: accounts/{account}
page_size

int32

Nombre maximal de produits à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. Si aucune valeur n'est spécifiée, le nombre maximal de produits est renvoyé.
page_token

string

Jeton de page reçu d'un appel ListProducts précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListProducts doivent correspondre à l'appel ayant fourni le jeton de page.

ListProductsResponse

Message de réponse pour la méthode ListProducts.

Champs
products[]

Product

Produits traités à partir du compte spécifié. Il s'agit des produits traités après l'application des règles et des sources de données supplémentaires.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

LoyaltyPoints

Message qui représente les points de fidélité.

Champs
name

string

Nom du programme de points de fidélité. Nous vous recommandons de limiter le nom à 12 caractères pleine largeur ou 24 caractères romains.
points_value

int64

Points de fidélité du marchand en valeur absolue.
ratio

double

Ratio d'un point converti en devise. Google se base sur la devise définie dans les paramètres Merchant Center. Si le ratio n'est pas renseigné, la valeur par défaut est 1.0.

LoyaltyProgram

Message qui représente un programme de fidélité.

Champs
program_label

string

Libellé du programme de fidélité. Ce libellé interne identifie de manière unique la relation entre un marchand et un programme de fidélité. Le libellé doit être fourni pour que le système puisse associer les composants ci-dessous (par exemple, le prix et les points) à un marchand. Le programme correspondant doit être associé au compte marchand.
tier_label

string

Libellé du niveau dans le programme de fidélité. Doit correspondre à l'un des libellés du programme.
price

Price

Prix pour les membres du niveau donné, c'est-à-dire la remise immédiate. La valeur doit être inférieure ou égale au prix standard.
cashback_for_future_use

Price

Cashback que vous pourrez utiliser pour vos futurs achats.
loyalty_points

int64

Nombre de points de fidélité gagnés pour un achat.

Produit

Produit traité, créé à partir de plusieurs [entrées de produit][[google.shopping.content.bundles.Products.ProductInput] après application des règles et des sources de données supplémentaires. Ce produit traité correspond à ce qui s'affiche dans votre compte Merchant Center, dans les annonces Shopping et sur les autres propriétés Google. Chaque produit est créé à partir d'une seule source de données principale et de plusieurs sources de données supplémentaires. Après l'insertion, la mise à jour ou la suppression d'une entrée produit, plusieurs minutes peuvent s'écouler avant que le produit traité mis à jour puisse être récupéré.

Tous les champs du produit traité et de ses sous-messages correspondent au nom de l'attribut correspondant dans les spécifications des données produit, à quelques exceptions près.

Champs
name

string

Nom du produit. Format : "{product.name=accounts/{account}/products/{product}}"
channel

ChannelEnum

Uniquement en sortie. Canal du produit.
offer_id

string

Uniquement en sortie. Identifiant unique du produit. Il en va de même pour le produit saisi et le produit traité. Les espaces blancs au début et à la fin sont supprimés, et plusieurs espaces blancs sont remplacés par un seul espace blanc lors de l'envoi. Pour en savoir plus, consultez les spécifications des données produit.
content_language

string

Uniquement en sortie. Code de langue ISO 639-1 à deux lettres du produit.
feed_label

string

Uniquement en sortie. Libellé du flux du produit.
data_source

string

Uniquement en sortie. Source de données principale du produit.
attributes

Attributes

Uniquement en sortie. Liste des attributs de produit.
custom_attributes[]

CustomAttribute

Uniquement en sortie. Liste d'attributs personnalisés (fournis par le marchand). Vous pouvez également l'utiliser pour envoyer n'importe quel attribut des spécifications des données sous sa forme générique (par exemple, { "name": "size type", "value": "regular" }). Cela est utile pour indiquer des attributs qui ne sont pas explicitement indiqués par l'API, tels que des attributs supplémentaires utilisés pour Acheter sur Google.
product_status

ProductStatus

Uniquement en sortie. État d'un produit, problèmes de validation des données (informations sur un produit calculé de manière asynchrone).
version_number

int64

Uniquement en sortie. Représente la version existante (fraîcheur) du produit, qui peut être utilisée pour préserver le bon ordre lorsque plusieurs mises à jour sont effectuées en même temps.

Si cette règle est définie, l'insertion est bloquée lorsque le numéro de version est inférieur à celui actuel du produit existant. La réinsertion (par exemple, actualiser le produit après 30 jours) peut être effectuée avec la version_number actuelle.

Compatible uniquement avec les insertions dans les sources de données principales.

Si l'opération est empêchée, l'exception annulée est générée.

ProductDetail

Informations détaillées sur le produit.

Champs
section_name

string

En-tête de section permettant de regrouper un ensemble d'informations détaillées sur un produit.
attribute_name

string

Nom des informations détaillées sur le produit.
attribute_value

string

Valeur des informations détaillées sur le produit.

ProductDimension

Dimension du produit.

Champs
value

double

Obligatoire. Valeur de la dimension représentée sous forme de nombre. La valeur peut avoir une précision maximale de quatre décimales.
unit

string

Obligatoire. Unités des dimensions. Les valeurs acceptées sont les suivantes: * "in" * "cm"

ProductInput

Cette ressource représente les données d'entrée que vous envoyez pour un produit, et non le produit traité que vous voyez dans Merchant Center, dans les annonces Shopping ou sur les surfaces Google. Les entrées produit, les règles et les données des sources de données supplémentaires sont combinées pour créer le [produit][google.shopping.content.bundles.Products.Product] traité.

Les attributs d'entrée de produit obligatoires pour réussir les contrôles de validation des données sont principalement définis dans les spécifications des données produit.

Les attributs suivants sont obligatoires: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] et [offerId][google.shopping.content.bundles.Products.offer_id].

Après l'insertion, la mise à jour ou la suppression d'un produit saisi, plusieurs minutes peuvent s'écouler avant que le produit traité ne puisse être récupéré.

Tous les champs de la saisie du produit et de ses sous-messages correspondent au nom en anglais de l'attribut correspondant dans la spécification du secteur, à l'exception de quelques exceptions.

Champs
name

string

Identifiant. Nom du produit saisi. Format : "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Uniquement en sortie. Nom du produit traité. Format : "{product.name=accounts/{account}/products/{product}}"
channel

ChannelEnum

Obligatoire. Immuable. Canal du produit.
offer_id

string

Obligatoire. Immuable. Identifiant unique du produit. Il en va de même pour le produit saisi et le produit traité. Les espaces blancs au début et à la fin sont supprimés, et plusieurs espaces blancs sont remplacés par un seul espace blanc lors de l'envoi. Pour en savoir plus, consultez les spécifications des données produit.
content_language

string

Obligatoire. Immuable. Code de langue ISO 639-1 à deux lettres du produit.
feed_label

string

Obligatoire. Immuable. Libellé du flux du produit.
attributes

Attributes

Facultatif. Liste des attributs de produit.
custom_attributes[]

CustomAttribute

Facultatif. Liste d'attributs personnalisés (fournis par le marchand). Vous pouvez également l'utiliser pour envoyer tout attribut des spécifications des données sous sa forme générique (par exemple, { "name": "size type", "value": "regular" }). Cela est utile pour indiquer des attributs qui ne sont pas explicitement indiqués par l'API, tels que les attributs supplémentaires utilisés pour Acheter sur Google. Le nombre maximal de caractères autorisé pour chaque attribut personnalisé est de 10 240 (correspond à la somme des caractères du nom et de la valeur). Vous pouvez définir jusqu'à 2 500 attributs personnalisés par produit, d'une taille totale de 102,4 ko. Les traits de soulignement dans les noms d'attributs personnalisés sont remplacés par des espaces lors de l'insertion.
version_number

int64

Facultatif. Représente la version existante (fraîcheur) du produit, qui peut être utilisée pour préserver le bon ordre lorsque plusieurs mises à jour sont effectuées en même temps.

Si cette règle est définie, l'insertion est bloquée lorsque le numéro de version est inférieur à celui actuel du produit existant. La réinsertion (par exemple, actualiser le produit après 30 jours) peut être effectuée avec la version_number actuelle.

Compatible uniquement avec les insertions dans les sources de données principales.

Si l'opération est empêchée, l'exception annulée est générée.

ProductStatus

État d'un produit, problèmes de validation des données (informations sur un produit calculé de manière asynchrone).

Champs
destination_statuses[]

DestinationStatus

Destinations prévues pour le produit.
item_level_issues[]

ItemLevelIssue

Liste de tous les problèmes associés au produit.
creation_date

Timestamp

Date de création de l'article, au format ISO 8601.
last_update_date

Timestamp

Date de la dernière mise à jour de l'article, au format ISO 8601.
google_expiration_date

Timestamp

Date d'expiration de l'article, au format ISO 8601.

DestinationStatus

État de la destination de l'état du produit.

Champs
reporting_context

ReportingContextEnum

Nom du contexte du rapport.
approved_countries[]

string

Liste des codes des pays (ISO 3166-1 alpha-2) dans lesquels l'offre est approuvée.
pending_countries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) pour lesquels l'offre est en attente d'approbation.
disapproved_countries[]

string

Liste des codes des pays (ISO 3166-1 alpha-2) pour lesquels l'offre est refusée.

ItemLevelIssue

ItemLevelIssue de l'état du produit.

Champs
code

string

Code d'erreur du problème
severity

Severity

Impact de ce problème sur la diffusion de l'offre
resolution

string

Indique si le problème peut être résolu par le marchand.
attribute

string

Nom de l'attribut, si le problème est causé par un seul attribut.
reporting_context

ReportingContextEnum

Contexte de reporting auquel s'applique le problème.
description

string

Une brève description du problème en anglais.
detail

string

Une description détaillée du problème en anglais.
documentation

string

URL d'une page Web qui vous aide à résoudre ce problème.
applicable_countries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) auxquels le problème s'applique à l'offre.

Gravité

l'impact du problème sur la diffusion du produit ;

Enums
SEVERITY_UNSPECIFIED Non spécifié.
NOT_IMPACTED Il s'agit d'un avertissement qui n'a pas d'incidence directe sur le produit.
DEMOTED Le produit est rétrogradé et ses performances sont probablement limitées dans les résultats de recherche
DISAPPROVED Le problème entraîne le refus du produit.

ProductStructuredDescription

Description structurée pour les descriptions générées par des algorithmes (IA).

Champs
digital_source_type

string

Type de source numérique, par exemple "trained_algorithmic_media". Selon les normes de l'IPTC. Ne doit pas dépasser 40 caractères
content

string

Le texte de description ne doit pas dépasser 5 000 caractères

ProductStructuredTitle

Titre structuré, pour les titres générés par des algorithmes (IA).

Champs
digital_source_type

string

Type de source numérique, par exemple "trained_algorithmic_media". Selon les normes de l'IPTC. Ne doit pas dépasser 40 caractères
content

string

Le texte du titre ne doit pas dépasser 150 caractères

ProductWeight

Poids du produit.

Champs
value

double

Obligatoire. Pondération sous forme de nombre. La précision maximale de la pondération est de quatre décimales.
unit

string

Obligatoire. Unité de poids. Les valeurs acceptées sont les suivantes: * "g" x "kg" x "oz" x "lb"

Shipping

Livraison du produit.

Champs
price

Price

Frais de port fixes, représentés par un nombre
country

string

Code CLDR du pays de livraison de l'article.
region

string

Zone géographique à laquelle les frais de port s'appliquent. Pour en savoir plus, consultez la section Région.
service

string

Description libre du niveau de service ou du délai de livraison.
location_id

int64

Identifiant numérique d'une zone géographique à laquelle les frais de port définis dans l'API AdWords s'appliquent.
location_group_name

string

Zone géographique où la livraison s'applique, représentée par un nom de groupe de zones géographiques.
postal_code

string

Plage de codes postaux à laquelle les frais de port s'appliquent. Il est représenté par un code postal, un préfixe de code postal suivi d'un caractère générique *, une plage entre deux codes postaux ou deux préfixes de codes postaux de même longueur.
min_handling_time

int64

Temps de traitement minimal (inclus) entre la réception de la commande et son expédition, en jours ouvrés. 0 signifie que la commande est expédiée le jour de sa réception si elle a lieu avant l'heure limite. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] ne peut être présent qu'avec [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time], mais il n'est pas obligatoire si [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] est présent.
max_handling_time

int64

Temps de traitement maximal (inclus) entre la réception de la commande et son expédition en jours ouvrés. 0 signifie que la commande est expédiée le jour de sa réception si elle a lieu avant l'heure limite. [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] et [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] sont obligatoires si vous indiquez des délais de livraison. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] est facultatif si [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] est spécifié.
min_transit_time

int64

Délai d'acheminement minimal (inclus) entre la date d'expédition de la commande et sa livraison, en jours ouvrés. 0 signifie que la commande est livrée le jour de l'expédition. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] ne peut être présent qu'avec [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time], mais il n'est pas obligatoire si [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] est présent.
max_transit_time

int64

Délai d'acheminement maximum (inclus) entre la date d'expédition de la commande et sa livraison, en jours ouvrés. 0 signifie que la commande est livrée le jour de l'expédition. [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] et [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] sont obligatoires si vous indiquez des délais de livraison. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] est facultatif si [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] est spécifié.

ShippingDimension

ShippingDimension du produit.

Champs
value

double

Dimensions du produit permettant de calculer les frais de port de l'article.
unit

string

Unité de valeur.

ShippingWeight

ShippingWeight du produit.

Champs
value

double

Poids du produit permettant de calculer les frais de port de l'article.
unit

string

Unité de valeur.

SubscriptionCost

SubscriptionCost du produit.

Champs
period

SubscriptionPeriod

Type de durée d'abonnement. Les valeurs acceptées sont les suivantes: * "month" * "year"
period_length

int64

Nombre de périodes d'abonnement que l'acheteur doit payer.
amount

Price

Montant que l'acheteur doit payer par période d'abonnement.

SubscriptionPeriod

Durée d'abonnement du produit.

Enums
SUBSCRIPTION_PERIOD_UNSPECIFIED Indique que la durée de l'abonnement n'est pas spécifiée.
MONTH Indique que la durée de l'abonnement est d'un mois.
YEAR Indique que la durée de l'abonnement est de l'année.

Taxes

Taxe appliquée au produit.

Champs
rate

double

Pourcentage du taux de taxe qui s'applique au prix de l'article.
country

string

Pays de taxation de l'article, sous forme d'un code CLDR.
region

string

Zone géographique à laquelle le taux de taxe s'applique.
tax_ship

bool

Défini sur "true" si une taxe est facturée sur la livraison.
location_id

int64

Identifiant numérique d'une zone géographique à laquelle un taux de taxe tel que défini dans l'API AdWords s'applique.
postal_code

string

Plage de codes postaux à laquelle le taux de taxe s'applique. Il est représenté par un code postal, un préfixe de code postal avec le caractère générique *, une plage entre deux codes postaux ou deux préfixes de codes postaux de même longueur. Exemples: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

UnitPricingBaseMeasurement du produit.

Champs
value

int64

Dénominateur du prix unitaire.
unit

string

Unité du dénominateur.

UnitPricingMeasure

UnitPricingMeasurement du produit.

Champs
value

double

Mesure d'un article.
unit

string

Unité de mesure.