Partager via

Procédure pas à pas : Application de bureau DE l’API Bing Ads en Java

  • Article

Ce guide explique comment télécharger des exemples Java pour l’API Bing Ads à partir de la source GitHub, modifier avec vos informations d’identification et exécuter dans une console locale.

Par défaut, les exemples sont prêts à s’exécuter dans l’environnement de bac à sable. Si vous ciblez l’environnement de production, vous aurez également besoin de votre jeton de développeur de production. Vous devez également inscrire une application et prendre note de l’ID d’application qui sera utilisé en tant que ClientId dans la procédure pas à pas ci-dessous. Pour plus d’informations sur l’inscription d’une application et le flux d’octroi du code d’autorisation, consultez Authentification avec OAuth.

Procédure pas à pas du code

  1. Installez Visual Studio Code et le débogueur pour Java . Vous pouvez modifier ces étapes si vous êtes déjà familiarisé avec un autre éditeur ou environnement de développement.

  2. Téléchargez et installez Git.

  3. Accédez à un répertoire local vide, par exemple c :\dev\BingAdsJava et clonez le Kit de développement logiciel (SDK) Java Bing Ads, par exemple, tapez git clone https://github.com/BingAds/BingAds-Java-SDK.git. Vous devez maintenant voir le répertoire du KIT de développement logiciel (SDK) qui contient à la fois la source du KIT de développement logiciel (SDK) et des exemples.

  4. Ouvrez Visual Studio Code et ouvrez le répertoire BingAdsDesktopApp (Fichier... Ouvrir le dossier...) Par exemple, C :\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp.

  5. Par défaut, les exemples sont prêts à s’exécuter dans l’environnement de bac à sable. Pour utiliser la production, dans C :\dev\BingAdsJava\BingAds-Java-SDK\examples\BingAdsDesktopApp\src\main\java\com\microsoft\bingads\examples\ExampleBase.java, définissez le API_ENVIRONMENT sur ApiEnvironment.PRODUCTION et modifiez le ClientId avec l’ID d’application qui a été provisionné lors de l’inscription de votre application. Vous devez également modifier la valeur DeveloperToken avec votre jeton de développeur de production.

  6. Ajoutez la dépendance Maven pour Microsoft.bingads à votre projet avant d’effectuer des appels d’API.

  7. Cliquez avec le bouton droit sur SearchUserAccounts.java, puis cliquez sur Exécuter.

  8. Vous devez être invité à copier et coller l’URL d’autorisation dans un navigateur web. Le consentement unique de l’utilisateur est requis. Par la suite, vous serez en mesure d’utiliser le jeton d’actualisation pour demander de nouveaux jetons d’accès et d’actualisation.

  9. Après avoir autorisé votre application à gérer vos comptes Microsoft Advertising, copiez l’URL obtenue (avec le paramètre de code ) et collez-la dans la fenêtre de console. Appuyez ensuite sur la touche Entrée (retour) pour poursuivre l’exécution.

  10. Le jeton d’actualisation sera écrit dansrefresh.txt. Les appels suivants à la fonction d’assistance authenticateWithOAuth tenteront de lire le jeton d’actualisation à partir du même emplacement. Vous pouvez modifier l’emplacement en modifiant le paramètre RefreshTokenPath dans ExampleBase.java.

    Importante

    Cet exemple de démarrage rapide n’est pas recommandé tel qu’il est en production. Vous devez uniquement stocker le jeton d’actualisation dans un emplacement sécurisé.

Voir aussi

Bac à sable
Exemples de code de l’API Bing Ads
Adresses du service web de l’API Bing Ads