Ressource Products

Article
11/13/2024

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	Optional. 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	Optional. 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	Optional. 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	Optional. 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	Optional. 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 ?
Emplacement	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

Option

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 bambin 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 <genre>	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.	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 <gentil>	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
mpn <mpn>	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 -installation -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 -installation -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. UA 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é menue 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 (Guiana française) PF (Polynésie française) 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
impôts <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. exclu 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	<gentil>
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	<bateau>

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.

Partager via