Partager via

Prise en main de l’API de contenu

  • Article

Pour utiliser l’API de contenu, vous aurez besoin de deux éléments :

  1. Un compte Microsoft.
  2. Un compte Microsoft Advertising
  3. Un jeton de développeur

Pour obtenir un compte Microsoft Advertising, accédez à https://ads.microsoft.com. Si vous n’êtes pas connecté à votre compte Microsoft, vous êtes redirigé pour vous connecter à votre compte ou pour vous inscrire à un compte. Une fois connecté, vous avez la possibilité de vous inscrire pour obtenir un nouveau compte Microsoft Advertising. Sélectionnez l’option d’inscription, puis cliquez sur Continuer.

Ensuite, si vous n’avez pas encore de jeton de développeur Microsoft Advertising pour l’environnement de production, accédez au portail des développeurs. Cliquez sur Demander un jeton et fournissez les informations demandées. Si vous utilisez l’API pour gérer votre propre compte, vous recevrez votre jeton immédiatement ; Toutefois, si vous gérez des comptes pour d’autres personnes, l’obtention d’un jeton peut prendre jusqu’à cinq jours ouvrables.

Authentification de vos informations d’identification

Importante

À compter du 1er juin 2022, nous exigerons l’authentification multifacteur pour tous les utilisateurs qui se connectent via une application tierce qui utilise l’API Bing Ads, l’API de contenu et les API d’hôtel.

Vous devez mettre à jour votre application pour obtenir le consentement de l’utilisateur à l’aide de la nouvelle msads.manage étendue. Tous les développeurs d’applications doivent prendre des mesures pour utiliser la nouvelle étendue.

Pour plus d’informations, consultez le Guide de configuration requise pour l’authentification multifacteur .

L’API de contenu utilise les mêmes schémas d’authentification que l’API Bing Ads. Pour plus d’informations sur l’authentification des informations d’identification de compte Microsoft avec OAuth, consultez Authentification avec le Plateforme d'identités Microsoft.

Vous pouvez utiliser le Kit de développement logiciel (SDK) Bing Ads pour .NET, Java ou Python pour authentifier les informations d’identification du compte Microsoft. Pour plus d’informations sur l’utilisation du Kit de développement logiciel (SDK) pour obtenir le jeton d’accès, consultez C# | Java | Python. Pour obtenir un exemple d’API de contenu qui utilise le Kit de développement logiciel (SDK) pour l’authentification, consultez Exemple de gestion des produits.

(Notez que le Kit de développement logiciel (SDK) Bing Ads ne fournit pas d’interfaces pour l’API de contenu. Vous ne devez utiliser le KIT de développement logiciel (SDK) pour obtenir le jeton d’accès que si vous utilisez également le KIT de développement logiciel (SDK) pour les campagnes Microsoft Advertising. Sinon, la surcharge liée à l’installation du Kit de développement logiciel (SDK) peut ne pas en valoir la peine.)

Si vous n’utilisez pas le Kit de développement logiciel (SDK) Bing Ads pour l’authentification, consultez Authentification des informations d’identification de compte Microsoft en C# pour obtenir un exemple montrant comment utiliser OAuth pour authentifier les informations d’identification du compte Microsoft.

Où utiliser vos informations d’identification et vos jetons de développeur ?

Tous les appels doivent spécifier :

  • En-tête DeveloperToken défini sur votre jeton de développeur.
  • En-tête AuthenticationToken défini sur votre jeton d’accès.

Si vous gérez des catalogues pour le compte d’autres clients, vous devez également définir les en-têtes suivants :

  • En-tête CustomerId défini sur l’ID client du client dont vous gérez le magasin
  • En-tête CustomerAccountId défini sur l’ID de compte de l’un des comptes du client que vous gérez (le compte géré n’a pas d’importance).

Pour plus d’informations sur ces en-têtes et d’autres que la demande et la réponse peuvent contenir, consultez En-têtes.

Configuration de Microsoft Merchant Center pour utiliser l’API

Pour obtenir une vue d’ensemble de Microsoft Merchant Center (MMC), consultez Qu’est-ce que Microsoft Merchant Center ? La rubrique inclut des liens vers toutes les rubriques du Merchant Center et des vidéos associées.

Si ce n’est déjà fait, vous devez effectuer les étapes suivantes.

  1. Vérifier et revendiquer l’URL de votre site web Pour obtenir les outils de webmestre mentionnés dans Vérifier et revendiquer l’URL de votre site web, consultez Outils bing Pour les webmestres. Connectez-vous avec le même compte Microsoft que celui que vous utilisez pour Microsoft Advertising. Pour plus d’informations sur l’utilisation de l’outil, consultez Vérifier la propriété de votre site web.
  2. Créer un magasin Microsoft Merchant Center
  3. Ajouter un catalogue

Lorsque vous créez un magasin MMC, le processus crée un catalogue par défaut pour vous. Le magasin et tous les catalogues que vous créez sont automatiquement activés pour la gestion des API. Le magasin contient un catalogue par défaut auquel toutes les opérations de produit (ajouter, mettre à jour, supprimer et obtenir) s’appliquent par défaut. Pour spécifier un autre catalogue, utilisez le paramètre de requête bmc-catalog-id dans l’URL de la ressource.

Pour ajouter et activer des catalogues, utilisez la ressource Catalogues . Pour plus d’informations, consultez Gestion de vos catalogues.

Remarque

Dans certaines circonstances, vous pouvez utiliser l’API et FTP/SFTP pour mettre à jour un flux de catalogue. Pour plus d’informations sur l’utilisation de l’API avec FTP/SFTP, consultez Puis-je utiliser l’API et FTP/SFTP ?

Étapes suivantes

Maintenant que vous êtes prêt à utiliser l’API, consultez les sections suivantes.