Package google.shopping.merchant.products.v1beta

Index

ProductInputsService

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

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Supprime une entrée de produit de votre compte Merchant Center.

Après avoir inséré, mis à jour ou supprimé une entrée de produit, il peut s'écouler plusieurs minutes avant que le produit traité 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 OAuth 2.0 Overview.

InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Importe une entrée produit dans votre compte Merchant Center. Si une entrée avec le même "contentLanguage", "offerId" et "dataSource" existe déjà, cette méthode remplace cette entrée.

Après avoir inséré, mis à jour ou supprimé une entrée de produit, il peut s'écouler plusieurs minutes avant que le produit traité 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 OAuth 2.0 Overview.

Service des produits

Service à utiliser pour la ressource "Product" (Produit). Ce service n'est disponible que pour les produits avec un canal en ligne.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

Après avoir inséré, mis à jour ou supprimé une entrée de produit, il peut s'écouler plusieurs minutes 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 OAuth 2.0 Overview.

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 ceux spécifiés par "pageSize". Utilisez le jeton de page pour déterminer si d'autres éléments doivent être demandés.

Après avoir inséré, mis à jour ou supprimé une entrée de produit, il peut s'écouler plusieurs minutes 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 OAuth 2.0 Overview.

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 indiquée dans productstatuses sous googleExpirationDate. Elle peut être anticipée si expirationDate est trop éloignée.

disclosure_date

Timestamp

Date et heure à laquelle une offre apparaît dans les résultats de recherche sur les 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é peut être expédié, au format ISO 8601.

gtin[]

string

Code article international (GTIN) de l'article. Vous pouvez fournir jusqu'à 10 GTIN.

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 du paiement par période pour un article associé à un contrat d'abonnement.

loyalty_points

LoyaltyPoints

Points de fidélité accordés une fois l'article acheté. Japon uniquement.

loyalty_programs[]

LoyaltyProgram

Liste d'informations sur le programme de fidélité utilisées pour présenter les avantages du programme (par exemple, des tarifs plus avantageux, des 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

Plage de dates de vente soldée de l'article (voir 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 bénéficie de la livraison gratuite.

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 tailles combinés pour les articles vestimentaires. Vous pouvez indiquer deux types de tailles maximum (voir [https://support.google.com/merchants/answer/6324497](type de taille)).

taxes[]

Tax

Informations fiscales.

unit_pricing_measure

UnitPricingMeasure

Mesure et dimensions d'un article.

unit_pricing_base_measure

UnitPricingBaseMeasure

Dénominateur à utiliser pour le prix unitaire.

ads_labels[]

string

Similaire à "ads_grouping", mais ne fonctionne que sur les CPC.

cost_of_goods_sold

Price

Prix de revient. Utilisé pour l'indication des profits bruts.

product_details[]

ProductDetail

Spécifications techniques ou informations supplémentaires sur le produit

product_highlights[]

string

Liste à 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 spécifiées dans excludedDestinations.

excluded_destinations[]

string

Liste des destinations à exclure pour cette cible (correspond aux cases non cochées dans Merchant Center)

shopping_ads_excluded_countries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) pour exclure l'offre de la destination Annonces Shopping. Les pays de cette liste sont supprimés de ceux 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 des 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) qui garantit que les remises sur les offres des marchands ne descendent pas en dessous de cette valeur, préservant ainsi la valeur et la rentabilité de l'offre.

sustainability_incentives[]

ProductSustainabilityIncentive

Liste des programmes d'incitation à la durabilité.

identifier_exists

bool

Définissez cette valeur sur "False" lorsque l'article ne possède pas de code produit unique adapté à sa catégorie (GTIN, référence fabricant ou marque). Si aucune valeur n'est indiquée, 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

Intitulé de l'article

description

string

Description de l'article.

adult

bool

Défini sur "Vrai" 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

Sexe du public auquel est destiné l'article.

google_product_category

string

Catégorie de Google pour l'article (voir 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.

item_group_id

string

Identifiant partagé de 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

Quantité du produit disponible à la vente sur Google. Réservé aux 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 des produits 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 des produits 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 différentes tailles, insérez un produit distinct pour chaque taille avec la même valeur itemGroupId (voir [https://support.google.com/merchants/answer/6324492](définition de la taille)).

size_system

string

Système d'indication de la taille. Recommandée pour les articles vestimentaires.

tax_category

string

Catégorie de taxe du produit.

energy_efficiency_class

string

Classe énergétique telle que définie dans la directive européenne 2010/30/UE.

min_energy_efficiency_class

string

Classe énergétique telle que définie dans la directive européenne 2010/30/UE.

max_energy_efficiency_class

string

Classe énergétique telle que définie dans la directive européenne 2010/30/UE.

multipack

int64

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

ads_grouping

string

Permet de regrouper aléatoirement des produits. Pour le pourcentage de CPA uniquement, déconseillé dans les autres cas.

ads_redirect

string

Permet aux annonceurs de remplacer l'URL de l'article lorsque celui-ci est proposé dans le contexte d'annonces pour un produit.

display_ads_id

string

Identifiant d'un article utilisé dans 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 dans les campagnes de remarketing dynamique.

pickup_method

string

Option de retrait en magasin pour l'article.

pickup_sla

string

Calendrier de retrait en magasin de 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-le si vous représentez une place de marché qui importe des produits pour différents vendeurs dans son 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 algorithme (IA).

structured_description

ProductStructuredDescription

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

Certification

Certification des produits, initialement introduite pour vérifier 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". La longueur maximale est de 2 000 caractères.

certification_name

string

Nom de la certification, par exemple "EPREL". La longueur maximale est de 2 000 caractères.

certification_code

string

Code de la certification. La longueur maximale est de 2 000 caractères.

certification_value

string

Valeur de la certification (également appelée classe, niveau ou note), par exemple "A+", "C" ou "or". La longueur maximale est de 2 000 caractères.

CloudExportAdditionalProperties

Propriété du produit pour l'API Cloud Retail. Par exemple, les propriétés d'un téléviseur peuvent être "Screen-Resolution" (Résolution de l'écran) ou "Screen-Size" (Taille de l'é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 de cette valeur est de 400. Les valeurs sont stockées dans un ordre arbitraire, mais cohérent. La taille maximale de la chaîne est de 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 téléviseur. Le nombre maximal de répétitions de 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 téléviseur, 1,2345. Le nombre maximal de répétitions de 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 taille maximale de la chaîne est de 256 caractères.

bool_value

bool

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

min_value

float

Valeur minimale en nombre flottant de la propriété donnée. Par exemple, pour un téléviseur, 1.00.

max_value

float

Valeur flottante maximale de la propriété donnée. Par exemple, 100,00 € pour un téléviseur.

unit_code

string

Unité de la propriété donnée. Par exemple, "Pixels" pour un téléviseur. La taille maximale de la chaîne 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}, où la dernière section product se compose de quatre parties : channel~content_language~feed_label~offer_id. Exemple de nom de produit : "accounts/123/productInputs/online~en~US~sku123"

data_source

string

Obligatoire. Source de données principale ou supplémentaire à partir de laquelle l'entrée de produit doit être supprimée. Format : accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Conditions à remplir pour qu'un produit bénéficie de la livraison gratuite.

Champs
country

string

Code CLDR du pays de livraison de l'article.

price_threshold

Price

Prix minimal du produit pour que les frais de port soient sans frais. Représenté sous forme de 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}, où la dernière section product se compose de quatre parties : channel~content_language~feed_label~offer_id. Exemple de nom de produit : "accounts/123/products/online~en~US~sku123"

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. Données du 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 sera déplacé vers une nouvelle source de données.

Seules les sources de données API sont acceptées.

Format : accounts/{account}/dataSources/{datasource}.

Versement

Message représentant un versement

Champs
months

int64

Nombre de versements que l'acheteur doit effectuer.

amount

Price

Montant que l'acheteur doit verser chaque mois.

downpayment

Price

Montant de l'acompte que l'acheteur doit payer au préalable.

credit_type

string

Type de versements Les valeurs acceptées sont: * "finance" * "lease"

ListProductsRequest

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

Champs
parent

string

Obligatoire. Compte pour lequel lister les produits transformés. Format: accounts/{account}

page_size

int32

Nombre maximal de produits à afficher. Le service peut renvoyer un nombre inférieur à cette valeur. La valeur maximale est 250. Les valeurs supérieures sont réduites à 250. Si ce paramètre n'est pas spécifié, 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 du compte spécifié. Il s'agit de vos produits traités après l'application de règles et de 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 représentant des points de fidélité.

Champs
name

string

Nom du programme de fidélité. Nous conseillons de limiter ce nom à 12 caractères pleine largeur ou 24 caractères latins.

points_value

int64

Points de fidélité du revendeur en valeur absolue.

ratio

double

Ratio d'un point converti en devise. Google utilise la devise par défaut en fonction des paramètres Merchant Center. Si le ratio n'est pas renseigné, la valeur par défaut est "1.0".

LoyaltyProgram

Message représentant un programme de fidélité.

Champs
program_label

string

Libellé du programme de fidélité. Il s'agit d'un libellé interne qui identifie de manière unique la relation entre une entité marchand et une entité de 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 du programme de fidélité. Doit correspondre à l'un des libellés du programme.

price

Price

Prix réservé aux membres du niveau donné, c'est-à-dire prix avec remise immédiate. Doit être inférieur ou égal au prix normal.

cashback_for_future_use

Price

Le cashback que vous pouvez utiliser pour de futurs achats.

loyalty_points

int64

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

member_price_effective_date

Interval

Période pendant laquelle l'article est éligible au prix membre. Si cette option n'est pas spécifiée, le prix membre est toujours appliqué. La plage de dates est représentée par une paire de dates ISO 8601 séparées par un espace, une virgule ou une barre oblique.

shipping_label

string

Libellé de l'avantage de livraison. Si le champ contient une valeur, cette offre bénéficie d'un avantage de livraison du programme de fidélité. Si la valeur du champ n'est pas fournie, l'article n'est pas éligible à la livraison du programme de fidélité pour le niveau de fidélité donné.

Produit

Produit traité, créé à partir de plusieurs product inputs après l'application de règles et de sources de données supplémentaires. Ce produit traité correspond à celui qui s'affiche dans votre compte Merchant Center, dans les annonces Shopping et sur les autres surfaces Google. Chaque produit est créé à partir d'une seule entrée de produit de la source de données principale et de plusieurs entrées de la source de données supplémentaire. Après avoir inséré, mis à jour ou supprimé une entrée de produit, il peut s'écouler plusieurs minutes 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}}", où la dernière section product se compose de quatre parties : channel~content_language~feed_label~offer_id. Exemple de nom de produit : "accounts/123/products/online~en~US~sku123"

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 l'entrée du produit et le produit transformé. Les espaces blancs au début et à la fin sont supprimés et plusieurs espaces blancs sont remplacés par un seul et unique espace blanc lors de la soumission. 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 pour le produit.

feed_label

string

Uniquement en sortie. Libellé du flux pour le 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). Elle peut également être utilisée 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 envoyer des attributs non explicitement indiqués par l'API, tels que les 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, c'est-à-dire informations sur un produit calculées 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 conserver l'ordre correct lorsque plusieurs mises à jour sont effectuées en même temps.

Si cet argument est défini, l'insertion est empêchée lorsque le numéro de version est inférieur au numéro de version actuel du produit existant. La réinsertion (par exemple, la mise à jour du produit après 30 jours) peut être effectuée avec l'version_number actuelle.

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

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

ProductDetail

Informations détaillées sur le produit.

Champs
section_name

string

En-tête de section utilisé pour 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 de la dimension. 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 plates-formes Google. Les entrées produit, les règles et les données de la source de données produit supplémentaire sont combinées pour créer l'Product traitée.

Les attributs de saisie de produits obligatoires pour réussir les vérifications de validation des données sont principalement définis dans les spécifications des données produit.

Les attributs suivants sont obligatoires: feedLabel, contentLanguage et offerId.

Après avoir inséré, mis à jour ou supprimé une entrée de produit, il peut s'écouler plusieurs minutes avant que le produit traité puisse être récupéré.

Tous les champs de l'entrée produit et de ses sous-messages correspondent au nom anglais de l'attribut correspondant dans la spécification du secteur, à quelques exceptions près.

Champs
name

string

Identifiant. Nom de l'entrée du produit. Format : "{productinput.name=accounts/{account}/productInputs/{productinput}}", où la dernière section productinput se compose de quatre parties : channel~content_language~feed_label~offer_id. Exemple de nom d'entrée de produit : "accounts/123/productInputs/online~en~US~sku123"

product

string

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

channel

ChannelEnum

Immuable. Canal du produit.

offer_id

string

Obligatoire. Immuable. Identifiant unique du produit. Il en va de même pour l'entrée du produit et le produit transformé. Les espaces blancs au début et à la fin sont supprimés et plusieurs espaces blancs sont remplacés par un seul et unique espace blanc lors de la soumission. 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). Elle peut également être utilisée 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 envoyer des attributs non 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és pour chaque attribut personnalisé est de 10 240 (correspond à la somme des caractères du nom et de la valeur). Vous pouvez définir 2 500 attributs personnalisés au maximum par produit, avec 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 conserver l'ordre correct lorsque plusieurs mises à jour sont effectuées en même temps.

Si cet argument est défini, l'insertion est empêchée lorsque le numéro de version est inférieur au numéro de version actuel du produit existant. La réinsertion (par exemple, la mise à jour du produit après 30 jours) peut être effectuée avec l'version_number actuelle.

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

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

ProductStatus

État d'un produit, problèmes de validation des données, c'est-à-dire informations sur un produit calculées 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 destination de l'état du produit.

Champs
reporting_context

ReportingContextEnum

Nom du contexte de création de rapports.

approved_countries[]

string

Liste des codes 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) dans lesquels l'offre est en attente d'approbation.

disapproved_countries[]

string

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

ItemLevelIssue

ItemLevelIssue de l'état du produit.

Champs
code

string

Code d'erreur du problème

severity

Severity

Indique comment ce problème affecte la diffusion de l'offre

resolution

string

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

attribute

string

Si le problème est causé par un attribut unique, nom de cet attribut

reporting_context

ReportingContextEnum

Contexte des rapports auquel le problème s'applique.

description

string

Description courte du problème en anglais.

detail

string

Description détaillée du problème en anglais

documentation

string

URL d'une page Web d'aide pour résoudre ce problème

applicable_countries[]

string

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

Gravité

Indique comment le problème affecte la diffusion du produit

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

ProductStructuredDescription

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

Champs
digital_source_type

string

Type de source numérique, par exemple "trained_algorithmic_media". Conformément aux normes IPTC. La longueur maximale est de 40 caractères.

content

string

La longueur maximale du texte de description est de 5 000 caractères

ProductStructuredTitle

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

Champs
digital_source_type

string

Type de source numérique, par exemple "trained_algorithmic_media". Conformément aux normes IPTC. La longueur maximale est de 40 caractères.

content

string

La longueur maximale du texte du titre est de 150 caractères

ProductSustainabilityIncentive

Informations sur les programmes d'incitation liés à la durabilité, comme les remises ou les exonérations fiscales

Champs
Champ d'union value. Valeur de l'avantage lié au développement durable. value ne peut être qu'un des éléments suivants :
amount

Price

Montant fixe de l'incitation.

percentage

double

Pourcentage du prix soldé auquel l'incitation s'applique.

type

Type

Programme d'incitation au développement durable

Type

Types de programmes d'incitation à la durabilité acceptés.

Enums
TYPE_UNSPECIFIED Type d'incitation à la durabilité non spécifié ou inconnu.
EV_TAX_CREDIT Programme offrant des réductions de la responsabilité fiscale pour les véhicules électriques et, dans certains pays, les hybrides rechargeables. Ces réductions peuvent être basées sur un montant spécifique ou un pourcentage du prix soldé.
EV_PRICE_DISCOUNT Un programme de subventions, souvent appelé "bonus écologique", offre une aide à l'achat de véhicules électriques et, dans certains pays, de véhicules hybrides rechargeables. Le montant de la subvention peut être une somme fixe ou un pourcentage du prix soldé.

ProductWeight

Poids du produit.

Champs
value

double

Obligatoire. Poids représenté sous forme de nombre. La pondération peut avoir une précision maximale de quatre décimales.

unit

string

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

Livraison

Livraison du produit.

Champs
price

Price

Frais de port fixes, représentés sous forme de 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 region.

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 indiqués dans l'API AdWords s'appliquent.

location_group_name

string

La 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 auxquels des frais de port s'appliquent. Il peut s'agir d'un code postal, d'un préfixe de code postal suivi d'un caractère générique *, d'une plage de codes postaux compris entre deux codes postaux ou de 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 même de sa réception, si elle est reçue avant l'heure limite. minHandlingTime ne peut être présent qu'avec maxHandlingTime, mais il n'est pas obligatoire si maxHandlingTime 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 même de sa réception, si elle est reçue avant l'heure limite. maxHandlingTime et maxTransitTime sont tous deux obligatoires si vous indiquez des délais de livraison. minHandlingTime est facultatif si maxHandlingTime est présent.

min_transit_time

int64

Délai d'acheminement minimal (inclus) entre le moment où la commande est expédiée et le moment où elle est livrée, en jours ouvrés. 0 signifie que la commande est livrée le même jour qu'elle est expédiée. minTransitTime ne peut être présent qu'avec maxTransitTime, mais il n'est pas obligatoire si maxTransitTime est présent.

max_transit_time

int64

Délai d'acheminement maximal (inclus) entre l'expédition de la commande et sa livraison en jours ouvrés. 0 signifie que la commande est livrée le même jour qu'elle est expédiée. maxHandlingTime et maxTransitTime sont tous deux obligatoires si vous indiquez des délais de livraison. minTransitTime est facultatif si maxTransitTime est présent.

ShippingDimension

Dimension de livraison du produit.

Champs
value

double

Dimensions du produit utilisées pour calculer les frais de port de l'article.

unit

string

Unité de valeur.

ShippingWeight

Poids du colis du produit.

Champs
value

double

Poids du produit utilisé pour calculer les frais de port de l'article.

unit

string

Unité de valeur.

SubscriptionCost

Coût de l'abonnement du produit.

Champs
period

SubscriptionPeriod

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

period_length

int64

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

amount

Price

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

SubscriptionPeriod

Période d'abonnement du produit.

Enums
SUBSCRIPTION_PERIOD_UNSPECIFIED Indique que la période d'abonnement n'est pas spécifiée.
MONTH Indique que la période d'abonnement est de 1 mois.
YEAR Indique que la période d'abonnement est d'un an.

Taxes

Taxe du 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 "Vrai" si une taxe est facturée lors de la livraison.

location_id

int64

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

postal_code

string

Plage de codes postaux auxquels un taux de taxe donné s'applique. Il peut s'agir d'un code postal, d'un préfixe de code postal utilisant un caractère générique *, d'une plage de codes postaux compris entre deux codes postaux ou de deux préfixes de codes postaux de même longueur. Exemples: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

UnitPricingBaseMeasure du produit.

Champs
value

int64

Dénominateur du prix unitaire.

unit

string

Unité du dénominateur.

UnitPricingMeasure

UnitPricingMeasure du produit.

Champs
value

double

Mesure d'un article.

unit

string

Unité de mesure.