REST Resource: accounts.products

Ressource : Product

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.

Représentation JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Champs
name

string

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

enum (ChannelEnum)

Uniquement en sortie. Canal du produit.
offerId

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

string

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

string

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

string

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

object (Attributes)

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

object (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.
productStatus

object (ProductStatus)

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

string (int64 format)

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

Attributs

Attributs.

Représentation JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Champs
expirationDate

string (Timestamp format)

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é.
disclosureDate

string (Timestamp format)

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

string (Timestamp format)

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

object (Price)

Prix de l'article
installment

object (Installment)

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

object (SubscriptionCost)

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

object (LoyaltyPoints)

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

object (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.
productTypes[]

string

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

object (Price)

Prix soldé annoncé de l'article.
salePriceEffectiveDate

object (Interval)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductWeight)

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

object (Shipping)

Règles de livraison.
freeShippingThreshold[]

object (FreeShippingThreshold)

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

object (ShippingWeight)

Poids de l'article pour la livraison.
shippingLength

object (ShippingDimension)

Longueur de l'article pour la livraison.
shippingWidth

object (ShippingDimension)

Largeur de l'article pour la livraison.
shippingHeight

object (ShippingDimension)

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

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[]

object (Tax)

Informations fiscales.
unitPricingMeasure

object (UnitPricingMeasure)

Mesure et dimension d'un article.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

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

string

Semblable à adsGrouping, mais ne fonctionne que sur le CPC.
costOfGoodsSold

object (Price)

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

object (ProductDetail)

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

string

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

string

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

string

Identifiant unique associé à une promotion.
includedDestinations[]

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.
excludedDestinations[]

string

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

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.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

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

object (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.
autoPricingMinPrice

object (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.
identifierExists

boolean

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

boolean

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

boolean

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

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
googleProductCategory

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

string

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

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

string

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string

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

string

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

number

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

string

Option de retrait de l'article.
pickupSla

string

Chronologie du retrait en magasin pour l'article.
customLabel0

string

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

string

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

string

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

string

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

string

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

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

object (ProductStructuredTitle)

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

object (ProductStructuredDescription)

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

Versement

Message représentant le versement.

Représentation JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Champs
months

string (int64 format)

Nombre de versements que l'acheteur doit effectuer.
amount

object (Price)

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

object (Price)

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

string

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

SubscriptionCost

SubscriptionCost du produit.

Représentation JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Champs
period

enum (SubscriptionPeriod)

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

string (int64 format)

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

object (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.

LoyaltyPoints

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

Représentation JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
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.
pointsValue

string (int64 format)

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

number

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

Représentation JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Champs
programLabel

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

string

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

object (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.
cashbackForFutureUse

object (Price)

Cashback que vous pourrez utiliser pour vos futurs achats.
loyaltyPoints

string (int64 format)

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

ProductDimension

Dimension du produit.

Représentation JSON 
{
  "value": number,
  "unit": string
}
Champs
value

number

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"

ProductWeight

Poids du produit.

Représentation JSON 
{
  "value": number,
  "unit": string
}
Champs
value

number

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.

Représentation JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Champs
price

object (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.
locationId

string (int64 format)

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

string

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

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

string (int64 format)

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

string (int64 format)

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é.
minTransitTime

string (int64 format)

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

string (int64 format)

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

FreeShippingThreshold

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

Représentation JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Champs
country

string

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

object (Price)

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

ShippingWeight

ShippingWeight du produit.

Représentation JSON 
{
  "value": number,
  "unit": string
}
Champs
value

number

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

string

Unité de valeur.

ShippingDimension

ShippingDimension du produit.

Représentation JSON 
{
  "value": number,
  "unit": string
}
Champs
value

number

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

string

Unité de valeur.

Taxes

Taxe appliquée au produit.

Représentation JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Champs
rate

number

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

boolean

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

string (int64 format)

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

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

UnitPricingMeasure

UnitPricingMeasurement du produit.

Représentation JSON 
{
  "value": number,
  "unit": string
}
Champs
value

number

Mesure d'un article.
unit

string

Unité de mesure.

UnitPricingBaseMeasure

UnitPricingBaseMeasurement du produit.

Représentation JSON 
{
  "value": string,
  "unit": string
}
Champs
value

string (int64 format)

Dénominateur du prix unitaire.
unit

string

Unité du dénominateur.

ProductDetail

Informations détaillées sur le produit.

Représentation JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Champs
sectionName

string

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

string

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

string

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

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

Représentation JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Champs
textValue[]

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.
intValue[]

string (int64 format)

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.
floatValue[]

number

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

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

boolean

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

number

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

number

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

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.

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.

Représentation JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Champs
certificationAuthority

string

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

string

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

string

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

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

ProductStructuredTitle

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

Représentation JSON 
{
  "digitalSourceType": string,
  "content": string
}
Champs
digitalSourceType

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

ProductStructuredDescription

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

Représentation JSON 
{
  "digitalSourceType": string,
  "content": string
}
Champs
digitalSourceType

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

ProductStatus

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

Représentation JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Champs
destinationStatuses[]

object (DestinationStatus)

Destinations prévues pour le produit.
itemLevelIssues[]

object (ItemLevelIssue)

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

string (Timestamp format)

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

string (Timestamp format)

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

string (Timestamp format)

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

DestinationStatus

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

Représentation JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Champs
reportingContext

enum (ReportingContextEnum)

Nom du contexte du rapport.
approvedCountries[]

string

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

string

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

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.

Représentation JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Champs
code

string

Code d'erreur du problème
severity

enum (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.
reportingContext

enum (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.
applicableCountries[]

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.

Méthodes

get

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

list

 Répertorie les produits traités dans votre compte Merchant Center.