Ressource Catalogs

La ressource Catalogues vous permet de gérer les catalogues dans votre magasin Microsoft Merchant Center (MMC). Pour plus d’informations sur l’utilisation des ressources Catalogs, consultez Gestion de vos catalogues. Pour obtenir des exemples qui montrent comment ajouter, supprimer et obtenir des catalogues, 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 que vous utilisez pour gérer vos catalogues, ajoutez le modèle approprié à l’URI de base.

Modèle	Verbe HTTP	Description	Ressource
{mmcMerchantId}/catalogs	POST	Utilisez pour ajouter un catalogue au magasin. Pour ajouter un catalogue, son nom doit être unique. Vous pouvez ajouter un maximum de 100 catalogues à un magasin. Définissez {mmcMerchantId} sur l’ID du magasin MMC.	Demande : Catalogue Réponse : Catalogue
{mmcMerchantId}/catalogs/{catalogId}	PUT	Utilisez pour mettre à jour un catalogue dans le magasin. Les seuls champs que vous pouvez mettre à jour sont les name champs et isPublishingEnabled , et vous devez spécifier les deux. Définissez {mmcMerchantId} sur l’ID du magasin MMC.	Demande : Catalogue Réponse : Catalogue
{mmcMerchantId}/catalogs/{catalogId}	SUPPRIMER	Utilisez pour supprimer un catalogue du magasin. Définissez {mmcMerchantId} sur l’ID du magasin MMC. Définissez {catalogId} sur l’ID du catalogue.	Demande : N/A Réponse : N/A
{mmcMerchantId}/catalogs/{catalogId}	GET	Utilisez pour obtenir un catalogue à partir du magasin. Définissez {mmcMerchantId} sur l’ID du magasin MMC. Définissez {catalogId} sur l’ID du catalogue.	Demande : N/A Réponse : Catalogue
{mmcMerchantId}/catalogs	GET	Utilisez pour obtenir une liste de catalogues à partir du magasin. Définissez {mmcMerchantId} sur l’ID du magasin MMC.	Demande : N/A Réponse : Catalogues

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.

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’authentification OAuth. Pour plus d’informations sur l’obtention d’un jeton, consultez Authentification de vos informations d’identification.
Emplacement du contenu	En-tête de réponse. URL qui identifie le magasin dans lequel le catalogue a été inséré. Cet en-tête est inclus dans la réponse d’une demande d’insertion.
CustomerAccountId	En-tête de la demande. ID de compte de l’un des comptes que vous gérez au nom 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 d’accès 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 catalogue 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 spécifiez pour la requête.

Objet	Description
Catalogue	Définit un catalogue.
Catalogues	Définit la liste des catalogues.

Catalog

Définit un catalogue.

Nom	Valeur	Type	Nom de l’élément XML
Id	ID qui identifie de façon unique le catalogue dans le magasin. Ce champ est en lecture seule ; ne définissez pas ce champ.	Long non signé	<Id>
isDefault	Valeur booléenne qui détermine si le catalogue est le catalogue par défaut du magasin. A la valeur true si le catalogue est le catalogue par défaut du magasin ; sinon, false. Lorsque vous créez un magasin, vous obtenez un catalogue par défaut dans lequel les produits sont écrits si vous ne spécifiez pas un autre catalogue. Ce champ est en lecture seule ; ne définissez pas ce champ.	Valeur booléenne	<is_default>
isPublishingEnabled	Valeur booléenne qui détermine si Microsoft peut publier des produits à partir du catalogue. Définissez sur true si Microsoft peut publier des produits à partir du catalogue ; sinon, définissez-la sur false. Vous pouvez mettre à jour ce champ. Vous pouvez également utiliser ce champ pour tester votre application avant de la déployer en production. En définissant ce champ sur false, vous pouvez effectuer des appels de ressources produits sans modifier ou publier vos données de production.	Valeur booléenne	<is_publishing_enabled>
Marché	Marché sur lequel les produits du catalogue sont publiés. NOTE: Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas. Voici les marchés possibles que vous pouvez spécifier. Albanie, Albanais (sq-AL) Andorre, Français (fr-AD) Argentine, espagnol (es-AR) Aruba, anglais (en-AW) Australie, anglais (en-AU) Autriche, Allemand (de-AT) Bahamas, anglais (en-BS) Bangladesh, anglais (en-BD) Belgique, Néerlandais (nl-BE) Belgique, Français (fr-BE) Bolivie, Espagnol (es-BO) Bosnie-Herzégovine, Bosnian (bs-BA) Brésil, Portugais (pt-BR) Brunéi, anglais (en-BN) Bulgarie, Bulgare (bg-BG) Canada, anglais (en-CA) Canada, Français (fr-CA) Îles Caïmans, anglais (en-KY) Chili, Espagnol (es-CL) Colombie, espagnol (es-CO) Costa Rica, Espagnol (es-CR) Croatie, Croate (hr-HR) Chypre, anglais (en-CY) Chypre, grec (el-CY) République tchèque, Tchèque (cs-CZ) Danemark, Danois (da-DK) Dominique, anglais (en-DM) République dominicaine, Espagnol (es-DO) Équateur, espagnol (es-CE) El Salvador, espagnol (es-SV) Estonie, Estonien (et-EE) Fidji, anglais (en-FJ) Finlande, Finnois (fi-FI) France, anglais (en-FR) France, Français (fr-FR) Français Guiana, Français (fr-GF) Français Polynésie, Français (fr-PF) Allemagne, anglais (en-DE) Allemagne, Allemand (de-DE) Grèce, anglais (en-GR) Grèce, Grec (el-GR) Guam, anglais (en-GU) Guatemala, Espagnol (es-GT) Guyana, anglais (en-GY) Haïti, Français (fr-HT) Honduras, Espagnol (es-HN) Hong Kong (R.A.S.), chinois traditionnel (zh-HK) Hongrie, anglais (en-HU) Hongrie, Hongrois (hu-HU) Islande, islandais (is-IS) Inde, anglais (en-IN) Indonésie, anglais (en-ID) Irlande, anglais (en-IE) Italie, anglais (en-IT) Italie, Italien (it-IT) Japon, Japonais (ja-JP) Lettonie, Letton (lv-LV) Liechtenstein, allemand (de-LI) Lituanie, Lituanien (lt-LT) Luxembourg, Français (fr-LU) Luxembourg, allemand (de-LU) Malaisie, anglais (en-MY) Maldives, anglais (en-MV) Malte, Malte (mt-MT) Martinique, Français (fr-MQ) Mexique, Espagnol (es-MX) Monaco, Français (fr-MC) Mongolie, anglais (en-MN) Monténégro, anglais (en-ME) Monténégro, Serbe (sr-ME) Montserrat, anglais (en-MS) Népal, anglais (en-NP) Pays-Bas, Néerlandais (nl-NL) Pays-Bas, anglais (el-NL) Nouvelle-Calédonie, Français (fr-NC) Nouvelle-Zélande, anglais (en-NZ) Macédoine du Nord, Macédonien (mk-MK) Norvège, Norvégien (nb-NO) Panama, Espagnol (es-PA) Papouasie-Nouvelle-Guinée, anglais (en-PG) Paraguay, Espagnol (es-PY) Pérou, Espagnol (es-PE) Phillippines, anglais (en-PH) Pologne, Polonais (pl-PL) Portugal, Portugais (pt-PT) Porto Rico, Espagnol (es-PR) Roumanie, Roumain (ro-RO) Saint-Marin, anglais (en-SM) Saint-Marin, italien (it-SM) Serbie, anglais (en-RS) Serbie, Serbe (sr-RS) Singapour, anglais (en-SG) Slovaquie, anglais (en-SK) Slovaquie, Slovaque (sk-SK) Slovénie, Slovène (sl-SI) Afrique du Sud, anglais (en-ZA) Espagne, anglais (en-ES) Espagne, Espagnol (es-ES) Sri Lanka, anglais (en-LK) Suède, anglais (en-SE) Suède, Suédois (sv-SE) Suisse, allemand (de-CH) Suisse, Français (fr-CH) Taïwan, chinois traditionnel (zh-TW) Thaïlande, anglais (en-TH) Trinité-et-Tobago, anglais (en-TT) Türkiye, turc (tr-TR) Royaume-Uni, anglais (en-GB) États-Unis, anglais (en-US) États-Unis, espagnol (es-US) Uruguay, Espagnol (es-UY) Cité du Vatican, italien (it-VA) Venezuela, Espagnol (es-VE) Vietnam, anglais (en-VN) Tous les produits que vous ajoutez au catalogue doivent spécifier le même marché (voir contentLanguage et targetCountry). Vous ne pouvez pas mettre à jour ce champ après avoir ajouté le catalogue au magasin. Dans la liste ci-dessus, de-DE est la valeur marchande que vous spécifiez ; n’incluez pas (Allemand-Allemagne) dans votre chaîne de marché.	Chaîne	<Marché>
Nom	Nom du catalogue. Le nom peut contenir un maximum de 70 caractères. Vous pouvez mettre à jour ce champ.	Chaîne	<name>

Catalogues

Définit une liste de catalogues.

Nom	Valeur	Type	Nom de l’élément XML
Catalogues	Liste des catalogues dans le magasin.	Catalog[]	<Catalogues>

Codes d’état HTTP

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

Code d'état	Description
200	Opération réussie.
201	Le catalogue a été ajouté.
204	Le catalogue 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.
401	Non autorisé Les informations d’identification de l’utilisateur ne sont pas valides.
404	Introuvable.
500	Erreur du serveur.