- Représentation JSON
- Versement
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- Livraison
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- Taxe
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- Certification
- ProductStructuredTitle
- ProductStructuredDescription
- ProductSustainabilityIncentive
- Type
Attributs.
Représentation JSON |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
Champs | |
---|---|
additional |
URL supplémentaires des images de l'article. |
expiration |
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 |
disclosure |
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 |
Le jour où un produit précommandé peut être expédié, au format ISO 8601. |
gtin[] |
Code article international (GTIN) de l'article. Vous pouvez fournir jusqu'à 10 GTIN. |
price |
Prix de l'article |
installment |
Nombre et montant des versements à payer pour l'achat d'un article. |
subscription |
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 de fidélité accordés une fois l'article acheté. Japon uniquement. |
loyalty |
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 |
Catégories de l'article (formatées selon les spécifications des données produit). |
sale |
Prix soldé annoncé de l'article. |
sale |
Plage de dates de vente soldée de l'article (voir spécifications des données produit). |
product |
Hauteur du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus). |
product |
Longueur du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus). |
product |
Largeur du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus). |
product |
Poids du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 2 000 (inclus). |
shipping[] |
Règles de livraison. |
free |
Conditions à remplir pour qu'un produit bénéficie de la livraison gratuite |
shipping |
Poids de l'article pour la livraison. |
shipping |
Longueur de l'article pour la livraison. |
shipping |
Largeur de l'article pour la livraison. |
shipping |
Hauteur de l'article pour la livraison. |
size |
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[] |
Informations fiscales. |
unit |
Mesure et dimensions d'un article. |
unit |
Dénominateur à utiliser pour le prix unitaire. |
ads |
Similaire à "adsGrouping", mais ne fonctionne que sur les CPC. |
cost |
Prix de revient. Utilisé pour l'indication des profits bruts. |
product |
Spécifications techniques ou informations supplémentaires sur le produit |
product |
Liste à puces décrivant les points forts les plus pertinents d'un produit. |
display |
Recommandations spécifiées par l'annonceur. |
promotion |
Identifiant unique associé à une promotion. |
included |
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 |
excluded |
Liste des destinations à exclure pour cette cible (correspond aux cases non cochées dans Merchant Center) |
shopping |
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. |
lifestyle |
URL supplémentaires des images de style de vie de l'article, utilisées pour identifier explicitement les images qui présentent votre article dans un contexte réel. Pour en savoir plus, consultez l'article du centre d'aide. |
cloud |
Champs supplémentaires à exporter vers le programme Cloud Retail. |
certifications[] |
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 |
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 |
Liste des programmes d'incitation à la durabilité. |
identifier |
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). La valeur par défaut est "true", si elle n'est pas fournie. |
is |
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 |
Intitulé de l'article |
description |
Description de l'article. |
link |
URL pointant directement vers la page de votre article sur votre boutique en ligne. |
mobile |
URL de la version optimisée pour les mobiles de la page de destination de votre article. |
canonical |
URL de la version canonique de la page de destination de votre article. |
image |
URL d'une image de l'article. |
adult |
Défini sur "Vrai" si l'article est destiné aux adultes. |
age |
Tranche d'âge cible de l'article. |
availability |
Disponibilité de l'article. |
brand |
Marque de l'article. |
color |
Couleur de l'article. |
condition |
Condition ou état de l'article. |
gender |
Sexe du public auquel est destiné l'article. |
google |
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 |
Identifiant partagé de toutes les variantes d'un même produit. |
material |
Matière de l'article. |
mpn |
Référence fabricant (MPN) de l'article. |
pattern |
Motif de l'article (par exemple, à pois). |
sell |
Quantité du produit disponible à la vente sur Google. Réservé aux produits en ligne. |
max |
Temps de traitement maximal du produit (en jours ouvrés). |
min |
Temps de traitement minimal du produit (en jours ouvrés). |
shipping |
Étiquette de livraison du produit, utilisée pour regrouper des produits dans les règles de livraison au niveau du compte. |
transit |
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 |
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 |
size |
Système d'indication de la taille. Recommandée pour les articles vestimentaires. |
tax |
Catégorie de taxe du produit. |
energy |
Classe énergétique telle que définie dans la directive européenne 2010/30/UE. |
min |
Classe énergétique telle que définie dans la directive européenne 2010/30/UE. |
max |
Classe énergétique telle que définie dans la directive européenne 2010/30/UE. |
multipack |
Nombre de produits identiques dans un multipack défini par le marchand. |
ads |
Permet de regrouper aléatoirement des produits. Pour le pourcentage de CPA uniquement, déconseillé dans les autres cas. |
ads |
Permet aux annonceurs de remplacer l'URL de l'article lorsque celui-ci est proposé dans le contexte d'annonces pour un produit. |
display |
Identifiant d'un article utilisé dans les campagnes de remarketing dynamique. |
display |
Titre d'un article pour les campagnes de remarketing dynamique. |
display |
URL pointant directement vers la page de destination de votre article utilisée dans les campagnes de remarketing dynamique. |
display |
Marge de l'offre dans les campagnes de remarketing dynamique. |
pickup |
Option de retrait en magasin pour l'article. |
pickup |
Calendrier de retrait en magasin de l'article. |
link |
Modèle de lien pour la vitrine du magasin hébergée par le marchand. |
mobile |
Modèle de lien pour la vitrine du magasin hébergée par le marchand optimisée pour les appareils mobiles. |
custom |
Étiquette personnalisée 0 pour un regroupement personnalisé d'articles dans une campagne Shopping. |
custom |
Étiquette personnalisée 1 pour un regroupement personnalisé d'articles dans une campagne Shopping. |
custom |
Étiquette personnalisée 2 pour un regroupement personnalisé d'articles dans une campagne Shopping. |
custom |
Étiquette personnalisée 3 pour un regroupement personnalisé d'articles dans une campagne Shopping. |
custom |
Étiquette personnalisée 4 pour un regroupement personnalisé d'articles dans une campagne Shopping. |
external |
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 |
La publication de cet élément sera temporairement suspendue. |
virtual |
URL de l'image 3D de l'article. Pour en savoir plus, consultez l'article du centre d'aide. |
structured |
Titre structuré, pour les titres générés par algorithme (IA). |
structured |
Description structurée, pour les descriptions générées par algorithme (IA). |
Versement
Message représentant un versement
Représentation JSON |
---|
{ "months": string, "amount": { object ( |
Champs | |
---|---|
months |
Nombre de versements que l'acheteur doit effectuer. |
amount |
Montant que l'acheteur doit verser chaque mois. |
downpayment |
Montant de l'acompte que l'acheteur doit payer au préalable. |
credit |
Type de versements Les valeurs acceptées sont: * " |
SubscriptionCost
Coût de l'abonnement du produit.
Représentation JSON |
---|
{ "period": enum ( |
Champs | |
---|---|
period |
Type de durée d'abonnement. Les valeurs acceptées sont: * " |
period |
Nombre de périodes d'abonnement que l'acheteur doit payer. |
amount |
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'une année. |
LoyaltyPoints
Message représentant des points de fidélité.
Représentation JSON |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
Champs | |
---|---|
name |
Nom du programme de fidélité. Nous conseillons de limiter ce nom à 12 caractères pleine largeur ou 24 caractères latins. |
points |
Points de fidélité du revendeur en valeur absolue. |
ratio |
Ratio d'un point converti en devise. Google utilise la devise par défaut en fonction des paramètres de 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é.
Représentation JSON |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
Champs | |
---|---|
program |
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 |
Libellé du niveau du programme de fidélité. Doit correspondre à l'un des libellés du programme. |
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 |
Le cashback que vous pouvez utiliser pour de futurs achats. |
loyalty |
Nombre de points de fidélité gagnés pour un achat. |
member |
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 |
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é. |
ProductDimension
Dimension du produit.
Représentation JSON |
---|
{ "value": number, "unit": string } |
Champs | |
---|---|
value |
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 |
Obligatoire. Unités de la dimension. Les valeurs acceptées sont les suivantes: * " |
ProductWeight
Poids du produit.
Représentation JSON |
---|
{ "value": number, "unit": string } |
Champs | |
---|---|
value |
Obligatoire. Poids représenté sous forme de nombre. La pondération peut avoir une précision maximale de quatre décimales. |
unit |
Obligatoire. Unité de poids. Les valeurs acceptées sont les suivantes: * " |
Livraison
Livraison du produit.
Représentation JSON |
---|
{
"price": {
object ( |
Champs | |
---|---|
price |
Frais de port fixes, représentés sous forme de nombre. |
country |
Code CLDR du pays de livraison de l'article. |
region |
Zone géographique à laquelle les frais de port s'appliquent. Pour en savoir plus, consultez la section region. |
service |
Description libre du niveau de service ou du délai de livraison. |
location |
Identifiant numérique d'une zone géographique à laquelle les frais de port indiqués dans l'API AdWords s'appliquent. |
location |
La zone géographique où la livraison s'applique, représentée par un nom de groupe de zones géographiques. |
postal |
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 |
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. |
max |
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. |
min |
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. |
max |
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. |
FreeShippingThreshold
Conditions à remplir pour qu'un produit bénéficie de la livraison gratuite
Représentation JSON |
---|
{
"country": string,
"priceThreshold": {
object ( |
Champs | |
---|---|
country |
Code CLDR du pays de livraison de l'article. |
price |
Prix minimal du produit pour que les frais de port soient sans frais. Représenté sous forme de nombre. |
ShippingWeight
Poids du colis du produit.
Représentation JSON |
---|
{ "value": number, "unit": string } |
Champs | |
---|---|
value |
Poids du produit utilisé pour calculer les frais de port de l'article. |
unit |
Unité de valeur. |
ShippingDimension
Dimension de livraison du produit.
Représentation JSON |
---|
{ "value": number, "unit": string } |
Champs | |
---|---|
value |
Dimensions du produit utilisées pour calculer les frais de port de l'article. |
unit |
Unité de valeur. |
Taxes
Taxe du produit.
Représentation JSON |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
Champs | |
---|---|
rate |
Pourcentage du taux de taxe qui s'applique au prix de l'article. |
country |
Pays de taxation de l'article, sous forme d'un code CLDR. |
region |
Région géographique à laquelle le taux de taxe s'applique. |
tax |
Défini sur "Vrai" si une taxe est facturée lors de la livraison. |
location |
Identifiant numérique d'une zone géographique à laquelle un taux de taxe indiqué dans l'API AdWords s'applique. |
postal |
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*. |
UnitPricingMeasure
UnitPricingMeasure du produit.
Représentation JSON |
---|
{ "value": number, "unit": string } |
Champs | |
---|---|
value |
Mesure d'un article. |
unit |
Unité de mesure. |
UnitPricingBaseMeasure
UnitPricingBaseMeasure du produit.
Représentation JSON |
---|
{ "value": string, "unit": string } |
Champs | |
---|---|
value |
Dénominateur du prix unitaire. |
unit |
Unité du dénominateur. |
ProductDetail
Informations détaillées sur le produit.
Représentation JSON |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
Champs | |
---|---|
section |
En-tête de section utilisé pour regrouper un ensemble d'informations détaillées sur un produit. |
attribute |
Nom des informations détaillées sur le produit. |
attribute |
Valeur des informations détaillées sur le produit. |
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).
Représentation JSON |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
Champs | |
---|---|
text |
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 |
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 |
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 |
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 |
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 |
Valeur minimale en nombre flottant de la propriété donnée. Par exemple, pour un téléviseur, 1.00. |
max |
Valeur flottante maximale de la propriété donnée. Par exemple, 100,00 € pour un téléviseur. |
unit |
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. |
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.
Représentation JSON |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
Champs | |
---|---|
certification |
L'autorité de certification, par exemple "European_Commission". La longueur maximale est de 2 000 caractères. |
certification |
Nom de la certification, par exemple "EPREL". La longueur maximale est de 2 000 caractères. |
certification |
Code de la certification. La longueur maximale est de 2 000 caractères. |
certification |
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. |
ProductStructuredTitle
Titre structuré, pour les titres générés par algorithme (IA).
Représentation JSON |
---|
{ "digitalSourceType": string, "content": string } |
Champs | |
---|---|
digital |
Type de source numérique, par exemple "trained_algorithmic_media". Conformément à l'IPTC. La longueur maximale est de 40 caractères. |
content |
La longueur maximale du texte du titre est de 150 caractères |
ProductStructuredDescription
Description structurée, pour les descriptions générées par algorithme (IA).
Représentation JSON |
---|
{ "digitalSourceType": string, "content": string } |
Champs | |
---|---|
digital |
Type de source numérique, par exemple "trained_algorithmic_media". Conformément à l'IPTC. La longueur maximale est de 40 caractères. |
content |
La longueur maximale du texte de description est de 5 000 caractères |
ProductSustainabilityIncentive
Informations sur les programmes d'incitation liés à la durabilité, comme les remises ou les exonérations fiscales
Représentation JSON |
---|
{ // Union field |
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 |
Montant fixe de l'incitation. |
percentage |
Pourcentage du prix soldé auquel l'incitation s'applique. |
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é "prime é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é. |