Ressource Products

  • Article

La ressource Products vous permet de gérer les offres de produits dans votre magasin Microsoft Merchant Center (MMC). Pour plus d’informations sur l’utilisation des ressources Products, consultez Gestion de vos produits. Pour obtenir des exemples qui montrent comment ajouter, supprimer et obtenir des produits, consultez Exemples de code.

Base URI

Voici l’URI de base auquel vous ajoutez les modèles.

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

Modèles

Pour créer les points de terminaison utilisés pour gérer vos offres de produits, ajoutez le modèle approprié à l’URI de base.

Modèle Verbe HTTP Description Ressource
{mmcMerchantId}/products/batch POST Utilisez pour effectuer plusieurs insertions (mises à jour), obtient et supprime dans une seule requête. Le lot ne doit pas inclure plusieurs actions pour le même produit. Par exemple, la demande ne doit pas essayer d’insérer et de supprimer le même produit.

Définissez {mmcMerchantId} sur l’ID du magasin MMC.		 Demande : Batch
Réponse : Batch
{mmcMerchantId}/products/{productUniqueId} SUPPRIMER Utilisez pour supprimer une seule offre de produit du store.

Définissez {mmcMerchantId} sur l’ID du magasin MMC.

Définissez {productUniqueId} sur l’ID de produit complet (par exemple, Online :en :US :Sku123).

Si vous avez inséré un produit avec le même ID dans plusieurs catalogues, il est supprimé de tous les catalogues.

La livraison des produits supprimés peut prendre jusqu’à 12 heures. Nous vous recommandons de mettre à jour la disponibilité du produit en « rupture de stock » avant la suppression.		 Demande : N/A
Réponse : N/A
{mmcMerchantId}/products/{productUniqueId} GET Utilisez pour obtenir une seule offre de produit dans le magasin.

Définissez {mmcMerchantId} sur l’ID du magasin MMC.

Définissez {productUniqueId} sur l’ID de produit complet (par exemple, Online :en :US :Sku123).

Si vous avez inséré un produit avec le même ID dans plusieurs catalogues, le service ne retourne qu’un seul d’entre eux, et lequel est indéterminé.		 Demande : N/A
Réponse : Produit
{mmcMerchantId}/products GET Utilisez pour obtenir la liste des produits dans le magasin.

Définissez {mmcMerchantId} sur l’ID du magasin MMC.		 Demande : N/A
Réponse : Produits
{mmcMerchantId}/products POST Utilisez pour insérer (mettre à jour) une seule offre de produit dans le magasin.

Si le produit n’existe pas, il est ajouté ; sinon, le produit est mis à jour. Étant donné que les mises à jour remplacent l’offre actuelle, vous devez inclure tous les champs qui composent l’offre.

Pour insérer l’offre dans un catalogue spécifique, spécifiez le paramètre de requête bmc-catalog-id ; sinon, le produit est inséré dans le catalogue par défaut du magasin.

Définissez {mmcMerchantId} sur l’ID du magasin MMC.

Notez que étant donné que les demandes Get/List et Delete agissent sur le magasin et non sur un catalogue spécifique, vous ne devez pas insérer un produit avec le même canal, contentLanguage, targetCountry et offerId dans plusieurs catalogues.		 Demande : Produit
Réponse : Produit

Paramètres de requête

Les points de terminaison peuvent inclure les paramètres de requête suivants.

Paramètre Description
alt Facultatif. Utilisez pour spécifier le type de contenu utilisé dans la demande et la réponse. Les valeurs possibles sont json et xml. La valeur par défaut est json.
bmc-catalog-id Facultatif. Utilisez pour spécifier le catalogue dans lequel insérer (mettre à jour) des offres de produits.

Utilisez ce paramètre si votre magasin contient plusieurs catalogues. Si vous ne spécifiez pas ce paramètre, le produit est inséré dans le catalogue par défaut du magasin.

Ce paramètre est utilisé uniquement pour insérer des offres de produits. Ce paramètre est ignoré pour les demandes Get, List et Delete, car elles fonctionnent sur plusieurs catalogues.
dry-run Facultatif. Utilisez lors du débogage de votre application pour tester les appels. Les appels qui incluent ce paramètre n’affectent pas les données de production (les produits ne sont pas insérés ou supprimés) ; Toutefois, la réponse contient toutes les erreurs générées par l’appel.

Tenez compte des limitations suivantes lors de l’utilisation de ce paramètre.
  • Les opérations d’insertion ne retournent pas d’ID.
  • Le service ne génère pas ou ne retourne pas de messages d’erreur secondaires tels que la qualité des données, les problèmes éditoriaux et les validations liées à la base de données.
Pour plus d’informations sur le test de votre application, consultez Bac à sable.
max-results Facultatif. Utilisez pour spécifier le nombre maximal d’éléments à retourner dans une demande de liste. La valeur maximale que vous pouvez spécifier est 250. La valeur par défaut est 25.
start-token Facultatif. Utilisez pour paginer la liste des produits d’un magasin. Le jeton identifie la page suivante des produits à retourner dans une demande de liste. Ne spécifiez pas ce paramètre dans la première demande de liste. Si le catalogue contient plus que le nombre de produits demandé (voir le paramètre de requête max-results ), la réponse inclut le nextPageToken champ (voir Produits), qui contient la valeur de jeton que vous utilisez dans la requête List suivante.

En-têtes

Voici les en-têtes de demande et de réponse.

En-tête Description
AuthenticationToken En-tête de la demande.

Définissez cet en-tête sur un jeton d’accès OAuth. Pour plus d’informations sur l’obtention d’un jeton d’accès, consultez Authentification de vos informations d’identification.
Emplacement du contenu En-tête de réponse.

URL qui identifie le magasin dans lequel le produit a été inséré. Cet en-tête est inclus dans la réponse d’une demande d’insertion.
Content-Type En-tête de la demande et de la réponse.

Type de contenu dans le corps de la demande ou de la réponse. Pour les fichiers POST, si vous utilisez JSON, définissez cet en-tête sur application/json. Sinon, si vous utilisez XML, définissez cet en-tête sur application/xml.
CustomerAccountId En-tête de la demande.

ID de compte de tout compte que vous gérez pour le compte du client spécifié dans l’en-tête CustomerId . Le compte que vous spécifiez n’a pas d’importance. Spécifiez cet en-tête uniquement si vous gérez un compte pour le compte du client.
Customerid En-tête de la demande.

ID client du client dont vous gérez le magasin. Spécifiez cet en-tête uniquement si vous gérez le magasin pour le compte du client. Si vous définissez cet en-tête, vous devez également définir l’en-tête CustomerAccountId .
DeveloperToken En-tête de la demande.

Jeton de développeur de l’application cliente. Chaque demande doit inclure cet en-tête. Pour plus d’informations sur l’obtention d’un jeton, consultez Avez-vous vos informations d’identification Microsoft Advertising et votre jeton de développeur ?
Lieu En-tête de réponse.

URL qui identifie le magasin dans lequel le produit a été inséré. Cet en-tête est inclus dans la réponse d’une demande d’insertion.
WebRequestActivityId En-tête de réponse.

ID de l’entrée de journal qui contient les détails de la demande. Vous devez toujours capturer cet ID si une erreur se produit. Si vous n’êtes pas en mesure de déterminer et de résoudre le problème, incluez cet ID avec les autres informations que vous fournissez à l’équipe de support technique.

Objets de requête et de réponse

Voici les objets de requête et de réponse utilisés par l’API.

Chaque objet définit le nom de clé JSON et le nom d’élément XML que vous utilisez en fonction du type de contenu que vous avez spécifié pour la requête.

Objet Description
Lot Définit la liste des éléments à traiter dans une demande de traitement par lots.
Erreur Définit une erreur.
ErrorResponse Définit l’objet d’erreur de niveau supérieur pour une insertion de produit unique.
BatchItemError Définit les erreurs qui se sont produites pour un élément pendant le traitement par lots.
Élément Définit un élément dans une demande ou une réponse par lot.
Produit Définit un produit.
ProductCustomAttribute Définit un attribut personnalisé.
ProductCustomGroup Définit un groupe d’attributs personnalisés.
ProductDestination Définit une destination.
ProductPrice Définit le prix d’un produit.
ProductTax Définit l’emplacement géographique qui détermine les taxes applicables.
Produits Définit une liste de produits.
ProductShipping Définit le coût d’expédition.
ProductShippingWeight Définit le poids d’expédition de l’article.
UnitPricing Définit le prix unitaire de l’article.
Warning Définit un message d’avertissement.

Lot

Définit la liste des éléments à traiter dans une demande de traitement par lots. Notez que cet objet est utilisé dans une requête et une réponse par lot.

Nom Valeur Type Nom de l’élément XML
Entrées Tableau d’éléments à traiter dans une demande de traitement par lots.

Le nombre maximal d’éléments que vous pouvez spécifier est de 12 000. Toutefois, la taille maximale de la demande étant de 4 Mo, le nombre réel d’éléments dépend du nombre d’attributs de produit (par exemple, taille, couleur, modèle) que vous incluez et de la compression des données. Par exemple, si vous compressez les données, vous pouvez spécifier 12 000 éléments, mais si ce n’est pas le cas, vous ne pouvez spécifier que 2 000 éléments.		 Item[] <Lot>

BatchItemError

Définit les erreurs qui se sont produites pour un élément pendant le traitement par lots.

Nom Valeur Type Nom de l’élément XML
erreurs Liste des erreurs qui se sont produites lors du traitement de l’élément. Erreur[] <Erreurs>
code Code de status HTTP de l’erreur. String
message Message associé à l’erreur. String

Erreur

Définit une erreur.

Nom Valeur Type Nom de l’élément XML
domaine À usage interne uniquement. String <Domaine>
emplacement Non utilisé. String <location type="string »>
locationType Non utilisé. String Voir l’attribut type de l’élément <location>
message Description de l’erreur. String <internalReason>
reason (Raison) Raison de l’échec de la demande. Par exemple, la validation du produit a échoué. String <Raison>

ErrorResponse

Définit l’objet d’erreur de niveau supérieur pour une insertion de produit unique.

Nom Valeur Type Nom de l’élément XML
error Liste des erreurs qui se sont produites lors du traitement de l’élément. Erreurs[] <Erreur>

Erreurs

Définit la liste des erreurs et des avertissements pour une offre.

Nom Valeur Type Nom de l’élément XML
erreurs Liste des erreurs qui se sont produites lors du traitement de l’élément. Erreur[] <Erreurs>
Avertissements Liste des avertissements qui se sont produits lors du traitement de l’élément. L’offre a été acceptée, mais vous devez résoudre les problèmes dès que vous le souhaitez. Par exemple, la console MMC renvoie des avertissements si vous ne spécifiez pas les identificateurs gtin, mpn et de marque s’ils doivent être connus. Avertissement[] <Avertissements>
code Le code de status HTTP ou l’erreur. String
message Message associé à l’erreur. String

Élément

Définit un élément dans une demande de traitement par lots.

Nom Valeur Type Nom de l’élément XML
batchId ID défini par l’utilisateur qui identifie cet élément dans la demande de lot. Par exemple, si le lot contient 10 éléments, vous pouvez leur attribuer les ID 1 à 10. Unsigned Integer <entry batch_id="unsigned integer » method="string »>
erreurs Objet d’erreur qui contient la liste des erreurs de validation qui se sont produites. La réponse inclut ce champ uniquement lorsqu’une erreur se produit. BatchItemError <Erreurs>
merchantId ID du magasin Merchant Center. Long non signé <merchant_id>
méthode Action à appliquer à l’élément. Les valeurs possibles sont insert, get et delete. Si l’élément ajoute ou met à jour une offre de produit, définissez la méthode sur insert; si l’élément supprime un produit, définissez la méthode sur delete; et si l’élément obtient un produit, définissez la méthode sur get. Les chaînes ne respectent pas la casse. String Voir l’attribut method de l’élément d’entrée <>
Produit Offre de produit. Spécifiez ce champ dans une requête uniquement en cas d’insertion (mise à jour) d’un produit. La réponse inclura ce champ pour les obtient et les insère (mises à jour) uniquement. Produit <Produit>
Productid ID de produit complet (par exemple, Online :en :US :Sku123). Incluez ce champ uniquement lors de l’obtention ou de la suppression d’une offre de produit.

N’incluez pas plusieurs éléments avec le même ID de produit dans une demande de lot.		 String <product_id>

Product

Définit un produit. Pour plus d’informations sur les champs de cet objet, consultez Comment le fichier de flux est-il organisé ?

Nom JSON et XML Valeur Type Requis pour l’insertion
additionalImageLinks

<additional_image_link>		 URL des images supplémentaires du produit qui peuvent être utilisées dans l’annonce du produit. Pour spécifier plusieurs images,

MMC n’utilise pas les images supplémentaires ; ce champ est inclus pour la compatibilité de Google.		 String[] Non
adult

<Adulte>		 Valeur booléenne qui détermine si l’article est un produit pour adultes. Définissez sur true si le marché cible de l’élément est des adultes. La valeur par défaut est False.

Notez que les produits pour adultes ne sont pas pris en charge et seront rejetés.		 Booléen Non
adwordsGrouping

<adwords_grouping>		 Groupe d’éléments pour l’appel d’offres au coût par acquisition (CPA).

MMC n’utilise pas ce champ ; il est inclus pour la compatibilité de Google.		 String Non
adwordsLabels

<adwords_label>		 Étiquettes des éléments groupés (voir adwordsGrouping). S’applique au coût par clic (CPC) uniquement.

MMC n’utilise pas ce champ ; il est inclus pour la compatibilité de Google.		 String[] Non
adwordsRedirect

<adwords_redirect>		 URL à utiliser dans l’annonce du produit. Si elle est spécifiée, cette URL doit être redirigée vers l’URL spécifiée dans link. String Non
ageGroup

<age_group>		 Groupe d’âge cible de l’élément. Voici les valeurs possibles.

  • adult
  • Enfants
  • Tout-petit
  • Enfant
  • Nouveau-né
 String Non
Disponibilité

<Disponibilité>		 Status de disponibilité du produit. Voici les valeurs possibles.

  • en stock
  • en rupture de stock
  • Précommande
La valeur par défaut est en stock.
 String Oui
availabilityDate

<availability_date>		 Date UTC à laquelle un produit en précommande sera disponible pour l’expédition (voir le availability champ). Ce champ est facultatif, mais si vous connaissez la date à laquelle le produit précommandé sera disponible pour l’expédition, vous devez définir ce champ. Spécifiez la date au format ISO 8601.

NOTE: La console MMC ignore actuellement le contenu de ce champ.		 String Non
Marque

<Marque>		 La marque, le fabricant ou l’éditeur de l’article. La chaîne peut contenir un maximum de 10 mots et 1 000 caractères. Pour vous assurer que la chaîne s’affiche correctement dans l’expérience utilisateur, vous devez limiter le nom de marque à 70 caractères maximum. String Oui
Canal

<Canal>		 Canal de vente du produit. Voici les valeurs possibles qui ne respectent pas la casse.

  • Local
  • Online
Étant donné que le canal est utilisé pour créer l’ID de produit, vous ne pouvez pas modifier ce champ après l’ajout du produit au magasin.		 String Oui
color

<Couleur>		 Couleur dominante du produit. Si la couleur est un mélange de couleurs, vous pouvez spécifier une liste délimitée par des barres obliques comprenant jusqu’à 3 couleurs (par exemple, rouge/vert/bleu).

Si une robe est disponible dans plusieurs couleurs, vous devez créer un produit pour chaque couleur et utiliser itemGroupId pour regrouper les variantes du produit.

Le champ est limité à 100 caractères.

Recommandé pour les vêtements.		 String Non
Condition

<Condition>		 Condition du produit. Voici les valeurs possibles.

  • Nouveau
  • Rénové
  • used
La valeur par défaut est nouvelle.		 String Oui
contentLanguage

<content_language>		 Code de langue ISO 639-1 à deux lettres pour le produit. Voici les valeurs possibles qui ne respectent pas la casse :
  • Albanais (sq)
  • Bosniaque (bs)
  • Bulgare (bg)
  • Croate (hr)
  • Tchèque (cs)
  • Néerlandais (nl)
  • Anglais (en)
  • Estonien (et)
  • Français (fr)
  • Allemand (de)
  • Grec (el)
  • Hongrois (hu)
  • Islandais (is)
  • Italien (it)
  • Letton (lv)
  • Lituanien (lt)
  • Macédonien (mk)
  • Maltais (mt)
  • Polonais (pl)
  • Portugais (pt)
  • Roumain (ro)
  • Serbe (sr)
  • Slovaque (sk)
  • Slovène (sl)
  • Espagnol (es)
  • Suédois (sv)
  • Turc (tr)
Étant donné que la langue est utilisée pour créer l’ID de produit, vous ne pouvez pas modifier ce champ après l’ajout du produit au magasin.		 String Oui
customAttributes

<custom_attribute>		 Liste des attributs personnalisés utilisés par le commerçant. ProductCustomAttribute[] Non
custom_group customGroups<> Liste des groupes personnalisés utilisés par le commerçant. ProductCustomGroup[] Non
customLabel0

<custom_label_0>		 Étiquette personnalisée 0, qui est utilisée pour filtrer les produits pour les campagnes Microsoft Shopping. L’étiquette est limitée à 100 caractères. String Non
customLabel1

<custom_label_1>		 Étiquette personnalisée 1, qui est utilisée pour filtrer les produits pour les campagnes Microsoft Shopping. L’étiquette est limitée à 100 caractères. String Non
customLabel2

<custom_label_2>		 Étiquette personnalisée 2, qui est utilisée pour filtrer les produits pour les campagnes Microsoft Shopping. L’étiquette est limitée à 100 caractères. String Non
customLabel3

<custom_label_3>		 Étiquette personnalisée 3, qui est utilisée pour filtrer les produits pour les campagnes Microsoft Shopping. L’étiquette est limitée à 100 caractères. String Non
customLabel4

<custom_label_4>		 Étiquette personnalisée 4, qui est utilisée pour filtrer les produits pour les campagnes Microsoft Shopping. L’étiquette est limitée à 100 caractères. String Non
description

<Description>		 Description du produit. La description peut ne pas inclure de texte promotionnel. La description est limitée à un maximum de 10 000 caractères et peut inclure des caractères Unicode.

La description fera l’objet d’une révision éditoriale.		 String Non
Destinations

<Destination>		 Destinations prévues du produit.

MMC n’utilise pas ce champ ; il est inclus pour la compatibilité de Google.		 ProductDestination[] Non
energyEfficiencyClass

<energy_efficiency_class>		 La classe d’efficacité énergétique telle que définie dans la directive européenne 2010/30/UE. Voici les valeurs possibles.

  • A
  • A+
  • A++
  • A+++
  • B
  • C
  • D
  • E
  • F
  • G
 String Non
expirationDate

<expiration_date>		 Date et heure UTC qui spécifient la date d’expiration du produit.

Si vous ne spécifiez pas de date d’expiration, le produit expire 30 jours à partir de la date et de l’heure que vous ajoutez ou mettez à jour le produit (la date et l’heure sont basées sur le fuseau horaire du serveur Microsoft).

Utilisez ce champ pour spécifier une date d’expiration inférieure à 30 jours à partir d’aujourd’hui.

Votre date d’expiration doit toujours inclure le composant d’heure et spécifier le fuseau horaire ou les informations de décalage. Si ce n’est pas le cas, l’API tente de déterminer le fuseau horaire à l’aide de targetCountry. Pour les pays ou régions avec plusieurs fuseaux horaires, l’API détermine le fuseau horaire à utiliser. Par exemple, si le pays est les États-Unis, l’API utilise l’heure standard du Pacifique (PST).

Vous devez suivre les produits qui approchent de l’expiration et avant qu’ils expirent, mettez à jour leur date d’expiration ou mettez simplement à jour le produit (vous n’avez pas besoin de mettre à jour les champs du produit), ce qui étend automatiquement la date d’expiration de 30 jours. Si vous définissez explicitement la date d’expiration, vous devez définir vous-même une nouvelle date d’expiration. La mise à jour du produit ne prolongera pas automatiquement la date d’expiration de 30 jours dans ce cas.		 String Non
gender

<Sexe>		 Sexe cible par le produit. Voici les valeurs possibles.

  • Femelle
  • Mâle
  • Unisexe
 String Non
googleProductCategory

<google_product_category>		 Catégorie de produit dans laquelle se trouve le produit. Vous pouvez spécifier une chaîne de catégorie (par exemple, Animals & Pet Supplies Pet Supplies > Pet supplies > Bird Supplies) ou un ID de catégorie (par exemple, 3). Pour une chaîne de catégorie, la liste des sous-catégories est délimitée par le symbole supérieur à («> »). Le champ est limité à 255 caractères.

Pour obtenir la liste des chaînes de catégorie et des ID, consultez Catégories.		 String Non
gtin

<gtin>		 Numéro gtin (Global Trade Item Number) attribué par le fabricant. Si le fabricant attribue un GTIN, vous devez le spécifier. Voici les types de GTIN.

  • EAN (Numéro d’article européen)
  • ISBN (International Standard Book Number)
  • JAN (numéro d’article japonais)
  • UPC (Universal Product Code)
 String Oui
Id

<Id>		 ID de produit complet. L’ID est un composite de channel, contentLanguage, targetCountry et offerId. L’ID respecte la casse.

Utilisez cet ID pour obtenir ou supprimer un produit.		 String Non
identifierExists

<identifier_exists>		 Valeur booléenne qui détermine si l’offre de produit spécifie les identificateurs gtin, mpn ou de marque . The default is true. Définissez sur false si vous ne spécifiez pas les trois identificateurs.

Les identificateurs de produit uniques définissent un produit dans une place de marché mondiale. L’étiquetage de vos produits avec des identificateurs uniques facilite la recherche de vos produits par les clients. Vous devez spécifier les trois identificateurs, s’ils sont connus.		 Booléen Non
Imagelink

<image_link>		 URL d’une image du produit qui peut être utilisée dans l’annonce du produit. L’URL est limitée à 1 000 caractères et peut utiliser le protocole HTTP ou HTTPS. Les types d’images autorisés sont bmp, gif, exif, jpg, png et tiff. La taille d’image recommandée est de 200 x 200 pixels. L’image ne peut pas dépasser 3,9 Mo.

L’image fera l’objet d’une révision éditoriale.		 String Oui
isBundle

<is_bundle>		 Valeur booléenne qui détermine si le produit est une offre groupée définie par le marchand. La valeur est true si le produit est une offre groupée. Booléen Non
itemGroupId

<item_group_id>		 ID qui peut être utilisé pour regrouper toutes les variantes du même produit. Par exemple, si la robe est disponible en 3 couleurs, vous pouvez créer un produit pour chaque couleur et utiliser cet ID pour les regrouper. En règle générale, vous regroupez les éléments qui varient selon la couleur, le matériau, le motif ou la taille.

L’ID doit être unique au sein d’un catalogue et est limité à 50 caractères.		 String Non
type

<Genre>		 Type de l’objet. Ce champ est défini sur content#product. String Non
Lien

<Lien>		 URL de la page du produit sur votre site web. L’URL est limitée à 2 000 caractères et peut utiliser le protocole HTTP ou HTTPS. Le domaine doit correspondre au domaine du magasin.

Le lien est utilisé dans l’annonce du produit. L’URL peut ne pas être redirigée. Pour utiliser une autre URL dans l’annonce de produit qui peut être redirigée vers cette URL, consultez adwordsRedirect.

La page web vers laquelle ce lien pointe fera l’objet d’une révision éditoriale.		 String Oui
Matériel

<Matériel>		 Matériau dominant du produit. Si le matériau est un mélange de matériaux, vous pouvez spécifier une liste délimitée par des barres obliques d’un maximum de 3 matériaux (par exemple, cuir/suède/soie).

Si une robe est disponible dans plusieurs matériaux, vous devez créer un produit pour chaque matériau et utiliser itemGroupId pour regrouper les variantes du produit.

Le champ est limité à 200 caractères.

Recommandé pour les vêtements.		 String Non
mobileLink

<mobile_link>		 URL d’une version optimisée pour les appareils mobiles de la page web qui contient des informations sur le produit (voir le lien). String Non
Multipack

<Multipack>		 Nombre de produits identiques vendus en une seule unité (par exemple, 4 lampes de poche). Lors de la définition du prix, il doit s’agir du prix total du multipack. Entier Non
Npp

<Npp>		 Numéro de pièce du fabricant (MPN) du produit. Si le fabricant attribue un MPN, vous devez le spécifier. Le MPN est limité à 70 caractères. String Oui
offerId

<offer_id>		 ID défini par l’utilisateur du produit proposé. L’ID d’offre ne respecte pas la casse et doit être unique au sein d’un catalogue et limité à un maximum de 50 caractères.

Étant donné que l’ID d’offre est utilisé pour créer l’ID de produit, vous ne pouvez pas modifier ce champ après l’ajout du produit au magasin.		 String Oui
onlineOnly

<online_only>		 Valeur booléenne qui détermine si le produit est uniquement disponible à l’achat en ligne. La valeur est true si le produit est disponible uniquement en ligne. La valeur par défaut est False. Booléen Non
modèle

<Modèle>		 Motif ou impression graphique du produit (par exemple, plaid). Le modèle est limité à 100 caractères.

Si une robe est disponible dans plusieurs modèles, vous devez créer un produit pour chaque modèle et utiliser itemGroupId pour regrouper les variantes du produit.

Recommandé pour les vêtements.		 String Non
Prix

<Prix>		 Prix du produit. Spécifiez le prix dans la devise du pays cible. Pour plus d’informations sur l’option d’inclure ou non la taxe dans le prix, consultez Politique fiscale du catalogue Microsoft Merchant Center. Le prix doit correspondre au prix indiqué sur la page web du produit (voir le lien) et doit être de la plage de 0,01 (1 cent) à 10000000,00 (10 millions).

Toutefois, si les conditions suivantes sont remplies, vous pouvez définir le prix sur 0,0 (zéro).

1. Le champ googleProductCategory est défini sur l’une des catégories suivantes :
    - Electronics > Communications > Téléphonie > Mobile Phones
    - Ordinateurs électroniques > Tablettes >
2. Le champ de titre contient l’un des mots clés suivants :
    -Contrat
    -Tranche
    -Bail
    -Paiement

Les mots clés ci-dessus sont affichés en anglais ; toutefois, le titre et la mot clé doivent être dans la langue du marché spécifié.

En règle générale, le titre contient des formulations telles que « ... avec plan d’versement » ou « ... avec contrat uniquement ». Le contrat mot clé peut être utilisé sur tous les marchés ; toutefois, les versements, paiements et baux ne peuvent être utilisés que sur le marché américain.		 ProductPrice Oui
productType

<product_type>		 Catégorie de produit définie par l’annonceur, qui peut être différente de googleProductCategory. Par exemple, Animals & Pet Supplies Pet fournit > des fournitures >> d’oiseaux vétérinaires. La liste des sous-catégories est délimitée par le symbole supérieur à (« »).> Le champ est limité à 750 caractères.

Vous pouvez spécifier plusieurs chaînes de catégorie délimitées par des virgules. Par exemple, Costumes & Accessoires > Perruque Accessoires > Capuchons, Costumes & Accessoires >> Perruques Colle.		 String Non
promotionId

<promotion_id>		 Liste d’ID délimités par des virgules qui identifient les promotions dans votre flux Promotions. Vous pouvez spécifier un maximum de 10 ID de promotion.

L’ID doit contenir au moins 1 caractère et un maximum de 60 caractères. Les caractères autorisés sont des caractères alphanumériques, un tiret (-) et un trait de soulignement (_).

Tous les ID d’un marché (voir contentLanguage et targetCountry) doivent être uniques. Par exemple, au sein d’un marché, vous ne pouvez pas utiliser PROMO1 et promo1, mais vous pouvez utiliser PROMO1 sur le marché en-US et promo1 sur le marché en-GB. Vous pouvez spécifier le même ID de promotion unique sur un ou plusieurs produits.

Microsoft promeut le produit si l’ID que vous spécifiez correspond à un ID de promotion dans votre flux Promotions (pour le même pays cible). Les ID correspondent uniquement si la casse est la même. Par exemple, les ID correspondent si l’ID du produit est PROMO1 et l’ID du flux est PROMO1, mais ils ne correspondent pas si l’ID du flux est Promo1.

Pour vous assurer que le produit n’est pas promu accidentellement à l’avenir, vous devez supprimer les ID des promotions qui se sont terminées. Bien que l’ID ne puisse pas être réutilisé dans un flux Promotions pendant 6 mois après la fin de la promotion, si l’ID est réutilisé dans une autre promotion par la suite, le produit est promu.		 String Non
salePrice

<sale_price>		 Prix de vente de l’article. Le prix de vente doit être de 0,01 (1 cent) à 10000000,00 (10 millions).

Pour les articles en vente, définissez le prix de vente et la date d’effet de la vente (voir salePriceEffectiveDate). Si vous définissez le prix de vente, mais pas la date d’entrée en vigueur du prix de vente, le prix de vente continuera d’être utilisé jusqu’à l’expiration du produit ou jusqu’à ce que vous définissiez une date d’effet.

Si les conditions suivantes sont remplies, vous pouvez définir le prix de vente sur 0,0 (zéro).

1. Le champ googleProductCategory est défini sur l’une des catégories suivantes :
    - Electronics > Communications > Téléphonie > Mobile Phones
    - Ordinateurs électroniques > Tablettes >
2. Le champ de titre contient l’un des mots clés suivants :
    -Contrat
    -Tranche
    -Bail
    -Paiement

Les mots clés ci-dessus sont affichés en anglais ; toutefois, le titre et la mot clé doivent être dans la langue du marché spécifié.

En règle générale, le titre contient des formulations telles que « ... avec plan d’versement » ou « ... avec contrat uniquement ». Le contrat mot clé peut être utilisé sur tous les marchés ; toutefois, les versements, paiements et baux ne peuvent être utilisés que sur le marché américain.		 ProductPrice Non
salePriceEffectiveDate

<sale_price_effective_date>		 Date de début et de fin UTC de la vente. Spécifiez les dates au format ISO 8601 . Par exemple, 2016-04-05T08 :00-08 :00/2016-04-10T19 :30-08 :00 (utilisez une barre oblique ('/') pour séparer les dates de début et de fin). Pour plus d’informations, reportez-vous à l’article salePrice. String Non
sellerName

<seller_name>		 Nom du marchand qui vend le produit. Utilisé uniquement par les agrégateurs pour identifier le commerçant. Les agrégateurs sont des sites tiers qui se comportent au nom de marchands individuels. Les produits qu’un agrégateur soumet au nom du commerçant doivent respecter les politiques et conditions d’utilisation de Microsoft Advertising.

Les agrégateurs doivent définir ce champ sur le nom des vendeurs. Si l’appelant n’est pas un agrégateur et que ce champ n’est pas défini, le nom du magasin est défini par défaut.

Le nom est limité à 255 caractères.		 String Non
livraison

<livraison>		 Prix d’expédition du produit en fonction de l’emplacement.

REMARQUE : l’expédition est obligatoire si le pays cible est DE (Allemagne) ; sinon, c’est facultatif.		 ProductShipping[] Oui
shippingLabel

<shipping_label>		 Étiquette d’expédition.

REMARQUE : les informations d’expédition sont requises si le pays cible est DE (Allemagne) ; sinon, c’est facultatif.		 String Oui
shippingWeight

<shipping_weight>		 Poids du produit. Le poids est utilisé à des fins d’expédition.

REMARQUE : les informations d’expédition sont requises si le pays cible est DE (Allemagne) ; sinon, c’est facultatif.		 ProductShippingWeight Oui
Tailles

<Taille>		 Tailles disponibles du produit. Par exemple, petite, moyenne et grande. Appliquez le dimensionnement de manière cohérente. La valeur de taille est définie par l’utilisateur, mais doit être basée sur votre pays cible. Ce champ est obligatoire pour tous les produits Vêtements & Accessoires lorsque vous ciblez : France, Allemagne, Royaume-Uni et États-Unis. String[] Non
sizeSystem

<size_system>		 Système de mesure utilisé pour dimensionner le produit. Par exemple, les chaussures peuvent être dimensionnées à l’aide du système américain ou du système britannique.

Voici les valeurs possibles.

  • AU
  • DE
  • FR
  • ROYAUME-UNI
  • US
La valeur par défaut est le système utilisé par le pays cible. Recommandé pour les vêtements.		 String Non
sizeType

<size_type>		 Coupe du produit. Voici les valeurs possibles.

  • Régulier
  • Maternité
  • petite
  • plus
  • grand et grand
La valeur par défaut est Régulière. Recommandé pour les vêtements.		 String Non
targetCountry

<target_country>		 Code de pays ISO 3166 à deux lettres du pays cible (pays dans lequel vous souhaitez publier le produit). Le pays doit correspondre au marché spécifié par le catalogue.

Voici les valeurs possibles qui ne respectent pas la casse :

  • AD (Andorre)
  • AL (Albanie)
  • AR (Argentine)
  • AW (Aruba)
  • AT (Autriche)
  • AU (Australie)
  • BS (Bahamas)
  • BD (Bangladesh)
  • BA (Bosnie-Herzégovine)
  • BE (Belgique)
  • BO (Bolivie)
  • BG (Bulgarie)
  • BR (Brésil)
  • BN (Brunéi)
  • CA (Canada)
  • KY (Îles Caïmans)
  • CH (Suisse)
  • CL (Chili)
  • CO (Colombie)
  • CR (Costa Rica)
  • CY (Chypre)
  • CZ (République tchèque)
  • DE (Allemagne)
  • DK (Danemark)
  • DM (Dominique)
  • DO (République dominicaine)
  • CE (Équateur)
  • SV (El Salvador)
  • EE (Estonie)
  • ES (Espagne)
  • FJ (Fidji)
  • FI (Finlande)
  • FR (France)
  • GF (Français Guiana)
  • PF (Français Polynésie)
  • GB (Grande-Bretagne)
  • GR (Grèce)
  • GU (Guam)
  • GT (Guatemala)
  • GY (Guyana)
  • HT (Haïti)
  • HN (Honduras)
  • HR (Croatie)
  • HU (Hongrie)
  • ID (Indonésie)
  • IE (Irlande)
  • IN (Inde)
  • IS (Islande)
  • IT (Italie)
  • LI (Liechtenstein)
  • LT (Lituanie)
  • LU (Luxembourg)
  • LV (Lettonie)
  • MV (Maldives)
  • MC (Monaco)
  • ME (Monténégro)
  • MK (Macédoine du Nord)
  • MT (Malte)
  • MQ (Martiniquais)
  • MY (Malaisie)
  • MX (Mexique)
  • MN (Mongolie)
  • MS (Montserrat)
  • NP (Népal)
  • NL (Pays-Bas)
  • NC (Nouvelle-Calédonie)
  • NO (Norvège)
  • NZ (Nouvelle-Zélande)
  • PA (Panama)
  • PG (Papouasie-Nouvelle-Guinée)
  • PH (Philippines)
  • PY (Paraguay)
  • PE (Pérou)
  • PL (Pologne)
  • PT (Portugal)
  • PR (Porto Rico)
  • RO (Roumanie)
  • RS (Serbie)
  • LK (Sri Lanka)
  • SE (Suède)
  • SG (Singapour)
  • SI (Slovénie)
  • SK (Slovaquie)
  • SM (Saint-Marin)
  • TH (Thaïlande)
  • TT (Trinité-et-Tobago)
  • TR (Türkiye)
  • États-Unis (États-Unis)
  • UT (Uruguay)
  • VA (Cité du Vatican)
  • VE (Venezuela)
  • VN (Vietnam)
  • ZA (Afrique du Sud)
Étant donné que le pays est utilisé pour créer l’ID de produit, vous ne pouvez pas modifier ce champ après avoir ajouté le produit au magasin.		 String Oui
Taxes

<Taxe>		 Informations fiscales du produit.

MMC n’utilise pas ce champ ; il est inclus pour la compatibilité de Google.		 ProductTax[] Non
Titre

<Titre>		 Titre du produit (par exemple, Chaussures pour femmes). Le titre peut ne pas inclure de texte promotionnel. Le titre est limité à un maximum de 150 caractères et peut inclure n’importe quel caractère Unicode.

Le titre fera l’objet d’une révision éditoriale.		 String Oui
unitPricingBaseMeasure

<unit_pricing_base_measure>		 Mesure de base du produit pour la tarification (par exemple, 100ml signifie que le prix est calculé sur la base d’une unité de 100ml).
  • Poids : oz, lb, mg, g, kg
  • Volume (US imperial) : floz, pt, qt, gal
  • Volume : ml, cl, l, cbm
  • Longueur : in, ft, yd, cm, m
  • Zone : sqft, m²
  • Par unité : ct

 UnitPricingBaseMeasure Non
unitPricingMeasure

<unit_pricing_measure>		 Mesure et dimension du produit au fur et à mesure de sa vente.
  • Poids : oz, lb, mg, g, kg
  • Volume (US imperial) : floz, pt, qt, gal
  • Volume : ml, cl, l, cbm
  • Longueur : in, ft, yd, cm, m
  • Zone : sqft, m²
  • Par unité : ct

 UnitPricingMeasure Non
validatedDestinations

<validated_destination>		 Liste en lecture seule des destinations prévues qui ont réussi la validation.

MMC n’utilise pas ce champ ; il est inclus pour la compatibilité de Google.		 String[] Non
Avertissements Liste des avertissements concernant les problèmes liés à l’offre de produit. L’offre a été acceptée, mais vous devez résoudre les problèmes dès que vous le souhaitez. Par exemple, la console MMC renvoie des avertissements si vous ne spécifiez pas les identificateurs gtin, mpn et de marque s’ils doivent être connus.

L’offre inclut ce champ uniquement dans la réponse d’une insertion/mise à jour.		 Avertissement[] Non

ProductCustomAttribute

Définit un attribut personnalisé.

Nom Valeur Type Nom de l’élément XML
nom Obtient ou définit le nom de l’attribut. String <Nom>
type Obtient ou définit le type de l’attribut. Voici les valeurs possibles.

  • valeur booléenne
  • datetimerange
  • float
  • group
  • int
  • Prix
  • text
  • Temps
  • url
 Chaîne <Type>
Unité Obtient ou définit l’unité de mesure de l’attribut. Utilisé pour les valeurs de type INT et FLOAT uniquement. String <Unité>
valeur Obtient ou définit la valeur de l’attribut. String <Valeur>

ProductCustomGroup

Définit un groupe d’attributs client.

Nom Valeur Type Nom de l’élément XML
attributes Obtient ou définit les attributs du groupe. ProductCustomAttribute <Attributs>
nom Obtient ou définit le nom du groupe. String <Nom>

ProductDestination

Définit une destination.

Nom Valeur Type Nom de l’élément XML
Intention Voici les valeurs possibles.

  • Valeur par défaut.
  • Exclus
  • facultatif
  • obligatoire
 String <Intention>
destinationName Obtient ou définit le nom de la destination. String <destination_name>

ProductPrice

Définit le prix ou le prix de vente d’un produit.

Nom Valeur Type Nom de l’élément XML
Monnaie Obtient ou définit la devise dans laquelle le prix est indiqué. Spécifiez la devise à l’aide des codes monétaires ISO 4217. Voici les valeurs possibles.

  • AUD (dollar australien)
  • CHF (franc suisse)
  • CAD (dollar canadien)
  • EUR (Euro)
  • GBP (livre britannique)
  • IDR (roupie indonésienne)
  • INR (roupie indienne)
  • MYR (ringgit malaisien)
  • NZD (dollar néo-zélandais)
  • PHP (peso des Philippines)
  • SEK (couronne suédoise)
  • SGD (dollar de Singapour)
  • THB (thai baht)
  • USD (États-Unis dollar)
  • VND (dong vietnamien)
 String currency Attribut.

Par exemple, <price currency="USD ».>.
valeur Obtient ou définit le prix de l’article. N’incluez pas de symboles monétaires tels que « $ ». Double Valeur de texte.

Par exemple, <price currency="USD">38.0<\price>.

Produits

Définit une liste de produits. Notez qu’il s’agit de l’objet de niveau supérieur retourné par la requête List.

Nom Valeur Type Nom de l’élément XML
type Obtient le type de l’objet. Ce champ est défini sur content#productsListResponse. String <Genre>
nextPageToken Obtient le jeton utilisé pour obtenir la page de résultats suivante. Si l’objet n’inclut pas ce champ, il n’y a plus de pages à obtenir. Consultez start-token. String <next_page_token>
resources Obtient la liste des produits. Si le catalogue ne contient aucune offre, le tableau est vide. Product[] <Produits>

ProductShipping

Définit le coût d’expédition.

Nom Valeur Type Nom de l’élément XML
country Obtient ou définit le code de pays ISO 3166 à deux lettres du pays où l’article est expédié. String <Pays>
locationGroupName Obtient ou définit le nom du groupe d’emplacements. String <location_group_name>
locationId Obtient ou définit l’ID de l’emplacement géographique où l’article est expédié. Pour obtenir la liste des ID, consultez Codes d’emplacement géographique. String <location_id>
postalCode Obtient ou définit le code postal ou la plage de codes postaux de l’emplacement où l’article est expédié. Vous pouvez spécifier le code postal comme suit :

  • Code postal complet : 94114

  • Code postal avec un caractère générique (suffixe uniquement) : 94*

  • Une plage de codes : 94002-95460

  • Plage de codes avec des caractères génériques (les préfixes de code postal doivent être de longueur égale : 94*-95*
 String <postal_code>
Prix Obtient ou définit le prix fixe pour expédier l’article à l’emplacement spécifié. ProductPrice <Prix>
Région Obtient ou définit la région géographique dans laquelle l’élément est expédié (par exemple, le code postal). String <Région>
service Obtient ou définit une description textuelle qui décrit la classe de service ou la vitesse de livraison. String <Service>

ProductShippingWeight

Définit le poids d’expédition de l’article.

Nom Valeur Type Nom de l’élément XML
Unité Obtient ou définit l’unité de mesure. String unit Attribut.

Par exemple, <shipping_weight unit="oz ».>
valeur Obtient ou définit le poids de l’élément, qui est utilisé pour calculer le coût d’expédition de l’article. String Valeur de texte.

Par exemple, <shipping_weight unit="oz">20.3<shipping_weight>.

ProductTax

Définit l’emplacement géographique qui détermine les taxes applicables.

Nom Valeur Type Nom de l’élément XML
country Obtient ou définit le pays dont le taux d’imposition s’applique. Utilise le code pays ISO 3166 à deux lettres. String <Pays>
locationId Obtient ou définit l’ID de l’emplacement géographique dont le taux d’imposition s’applique. Pour obtenir la liste des ID, consultez Codes d’emplacement géographique. Entier long <location_id>
postalCode Obtient ou définit le code postal ou la plage de codes postaux dont le taux de taxe s’applique. Vous pouvez spécifier le code postal comme suit :

  • Code postal complet : 94114

  • Code postal avec un caractère générique (suffixe uniquement) : 94*

  • Une plage de codes : 94002-95460

  • Plage de codes avec des caractères génériques (les préfixes de code postal doivent être de longueur égale : 94*-95*
 String <postal_code>
Taux Obtient ou définit le taux de taxe en pourcentage à appliquer au prix de l’article. Pour spécifier un taux de 5 %, définissez ce champ sur 5. Pour spécifier un taux de 9,8 %, définissez ce champ sur 9,8. Double <Taux>
Région Obtient ou définit une région géographique dont le taux d’imposition s’applique. String <Région>
impôts Obtient ou définit une valeur booléenne qui détermine s’il faut appliquer la taxe au coût d’expédition. Définissez sur true si la taxe est facturée lors de l’expédition. Boolean <Navire>

UnitPricing

Définit le prix unitaire de l’article.

Nom Valeur Type Nom de l’élément XML
Unité Obtient ou définit l’unité de mesure. Par exemple, oz si le prix est par once. String unit Attribut.

Par exemple, <unit_pricing_measure unit="oz »>
valeur Obtient ou définit le prix par unité. Double Valeur de texte.

Par exemple, <unit_pricing_measure unit="oz">34.5<\unit_pricing_measure>

Avertissement

Définit un message d’avertissement.

Nom Valeur Type Nom de l’élément XML
domaine À usage interne uniquement. String <Domaine>
message Description de l’avertissement. String <internalReason>
reason (Raison) Raison pour laquelle l’offre a généré un avertissement. Par exemple, vous n’avez pas fourni d’identificateur (gtin, mpn ou marque) lorsque le fabricant les a attribués. String <Raison>

Codes d’état HTTP

Les requêtes peuvent retourner les codes de status HTTP suivants.

Code d'état Description
200 Opération réussie.
204 Le produit a été supprimé.
400 Demande incorrecte Une valeur de paramètre de requête n’est pas valide ou quelque chose dans le corps de la requête n’est pas valide.

Lot : si une erreur se produit, l’élément de lot qui a échoué inclut les erreurs.
401 Non autorisé Les informations d’identification de l’utilisateur ne sont pas valides.
404 Introuvable.
409 Conflit. L’opération n’a pas pu être terminée en raison d’un conflit avec l’état actuel de la ressource.
413 Entité de demande trop grande. La taille de la requête dépasse le maximum autorisé.
500 Erreur du serveur.