Gestion de vos catalogues

  • Article

L’API de contenu est une API RESTful qui utilise la ressource Catalogs pour gérer les catalogues dans votre magasin MMC (Microsoft Merchant Center).

Voici l’URI de base que vous utilisez pour appeler l’API de contenu.

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

Chaque requête HTTP doit inclure le jeton d’accès OAuth de l’utilisateur et votre jeton de développeur. Pour spécifier le jeton d’accès de l’utilisateur, définissez l’en-tête AuthenticationToken . Pour spécifier votre jeton de développeur, définissez l’en-tête DeveloperToken .

Si vous gérez des catalogues pour le compte d’autres clients, vous devez définir :

  • En-tête CustomerId de l’ID client du client dont vous gérez le magasin.
  • En-tête CustomerAccountId de l’ID de compte de l’un des comptes du client que vous gérez (peu importe le compte géré).

Par défaut, l’API de contenu utilise des objets JSON pour représenter les catalogues. Pour utiliser du code XML, définissez le paramètre de requête alt sur XML.

Pour plus d’informations sur l’utilisation de la ressource Catalogs, consultez les sections suivantes.

Pour obtenir un exemple de code qui montre comment obtenir, ajouter, mettre à jour et supprimer des catalogues, consultez Exemple de code de gestion des catalogues.

Obtention d’un catalogue à partir du magasin

Pour obtenir un catalogue à partir du magasin, ajoutez le modèle suivant à l’URI de base.

{bmcMerchantId}/catalogs/{catalogId}

Définissez sur {bmcMerchantId} votre ID de magasin MMC et sur {catalogId}l’ID du catalogue.

Envoyez une requête HTTP GET à l’URL obtenue. Si le catalogue a été trouvé, la réponse contient un objet Catalog qui contient les détails du catalogue.

Obtention d’une liste de catalogues à partir du magasin

Pour obtenir la liste des catalogues à partir du magasin, ajoutez le modèle suivant à l’URI de base.

{bmcMerchantId}/catalogs

Définissez sur {bmcMerchantId} votre ID de magasin MMC.

Envoyez une requête HTTP GET à l’URL obtenue. Si le magasin contient des catalogues, la réponse contient un objet Catalogs qui contient la liste des catalogues.

Suppression d’un catalogue du magasin

Pour supprimer un catalogue du magasin, ajoutez le modèle suivant à l’URI de base.

{bmcMerchantId}/catalogs/{catalogId}

Définissez sur {bmcMerchantId} votre ID de magasin MMC et sur {catalogId}l’ID du catalogue.

Envoyez une requête HTTP DELETE à l’URL obtenue. Si le catalogue a été trouvé, il est supprimé.

Ajout d’un catalogue au magasin

Vous utilisez des catalogues pour regrouper logiquement vos produits. Pour ajouter un catalogue au magasin, ajoutez le modèle suivant à l’URI de base.

{bmcMerchantId}/catalogs

Définissez sur {bmcMerchantId} votre ID de magasin MMC.

Envoyez une requête HTTP POST à l’URL obtenue. Si le catalogue est ajouté, la réponse contient un objet Catalog . L’objet Catalog inclut l’ID du catalogue. Utilisez l’ID pour obtenir et supprimer le catalogue.

Le corps de la requête est un objet Catalog . Vous devez spécifier les champs suivants.

Le nom que vous spécifiez doit être unique dans le magasin et être limité à un maximum de 70 caractères. Le marché identifie l’endroit où les produits sont servis. Pour obtenir la liste des marchés pris en charge, consultez marché. Les produits sont servis uniquement si isPublishingEnabled a la valeur true. Pour plus d’informations sur la façon dont vous pouvez utiliser isPublishingEnabled pour tester votre application, consultez Test de votre code dans le bac à sable.

Mise à jour d’un catalogue dans le magasin

Pour mettre à jour un catalogue dans le magasin, ajoutez le modèle suivant à l’URI de base.

{bmcMerchantId}/catalogs/{catalogId}

Définissez sur {bmcMerchantId} votre ID de magasin MMC et sur {catalogId}l’ID du catalogue.

Le corps de la requête est un objet Catalog . Vous devez spécifier les champs suivants.

Envoyez une requête HTTP PUT à l’URL obtenue. Si le catalogue est mis à jour, la réponse contient l’objet Catalog mis à jour.