Prise en main de l’API Hôtel
Remarque
Cette version bêta de Hotel Price Ads est disponible uniquement pour certains participants. Pour plus d’informations sur la participation au programme de version bêta, contactez votre responsable de compte ou inscrivez-vous ici.
L’API et la documentation sont susceptibles d’être modifiées.
Avez-vous vos informations d’identification Microsoft Advertising ?
Pour utiliser l’API Hôtel, vous devez disposer d’un compte Microsoft Advertising et d’un compte Microsoft. Pour obtenir un compte Microsoft Advertising, accédez à https://ads.microsoft.com. Si vous n’êtes pas connecté à l’aide de votre compte Microsoft, vous êtes invité à vous connecter à votre compte Microsoft ou à vous inscrire pour obtenir un compte Microsoft. Une fois connecté, vous avez la possibilité de vous inscrire pour obtenir un nouveau compte Microsoft Advertising. Sélectionnez l’option d’inscription et poursuivez le processus d’inscription.
Contrairement aux autres API Bing Ads, l’API Hôtel n’utilise pas de jeton de développeur. L’API l’ignore si vous l’incluez.
Activer votre compte pour les annonces de prix d’hôtel
Une fois que nous aurons reçu vos informations d’inscription, nous vous contacterons par e-mail pour connaître les étapes suivantes.
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 Hotel utilise le schéma d’authentification OAuth. Pour plus d’informations sur l’authentification des informations d’identification de compte Microsoft à l’aide d’OAuth, consultez Authentification avec OAuth (l’utilisation de la Plateforme d'identités Microsoft est recommandée).
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. Vous pouvez uniquement utiliser le Kit de développement logiciel (SDK) pour obtenir le jeton d’accès si vous utilisez également le Kit de développement logiciel (SDK) pour les campagnes Microsoft Advertising. Dans le cas contraire, la surcharge liée à l’installation du KIT de développement logiciel (SDK) peut ne pas en valoir la peine.
Si vous choisissez de ne pas utiliser le Kit de développement logiciel (SDK) Bing Ads pour obtenir les jetons, consultez Exemple C# OAuth pour obtenir un exemple d’implémentation OAuth.
Remarque
Si vous utilisez l’API à partir d’un service, consultez Utilisation de l’API Hôtel à partir d’un service.
Où utilisez-vous vos informations d’identification ?
Après avoir obtenu le jeton d’accès OAuth de l’utilisateur, définissez-y l’en-tête Authorization.
var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);
Pour plus d’informations sur l’en-tête Authorization et les autres en-têtes que la demande et la réponse peuvent contenir, consultez En-têtes.
Remarque
L’API Hotel utilise l’en-tête d’autorisation standard. Si vous utilisez le Kit de développement logiciel (SDK) Bing Ads pour obtenir les jetons OAuth, vous allez utiliser le SDK pour obtenir les jetons, puis définir l’en-tête d’autorisation.
Avez-vous configuré votre flux d’hôtel ?
Avant d’utiliser l’API Hôtel, vous devez configurer vos flux d’hôtel. Pour obtenir des informations détaillées, voir :