Procédure pas à pas : Application de bureau API Bing Ads en PHP

  • Article

Ce guide explique comment télécharger des exemples PHP 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. Accédez à un répertoire local vide, par exemple c :\dev\BingAdsPHP et installez le Kit de développement logiciel (SDK) PHP Bing Ads, par exemple, tapez composer require microsoft/bingads. Vous devez maintenant voir le répertoire du fournisseur qui contient à la fois la source du KIT de développement logiciel (SDK) et les exemples.

  2. Copiez le répertoire V13 (avec les exemples inclus) dans le répertoire de votre projet local, par exemple, copiez de c :\dev\BingAdsPHP\vendor\microsoft\bingads\samples vers c :\dev\BingAdsPHP.

  3. Par défaut, les exemples sont prêts à s’exécuter dans l’environnement de bac à sable. Pour utiliser la production, dans c :\dev\BingAdsPHP\V13\AuthHelper.php, définissez ApiEnvironmentApiEnvironment::Production sur 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.

  4. À l’invite de commandes de la console, exécutez l’exemple, par exemple, tapez php .\V13\SearchUserAccounts.php.

  5. 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.

  6. 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.

  7. Le jeton d’actualisation sera écrit dansrefresh.txt. Les appels suivants à la fonction d’assistance d’authentification tenteront de lire le jeton d’actualisation à partir du même emplacement. Vous pouvez modifier l’emplacement en modifiant le paramètre OAuthRefreshTokenPath dans AuthHelper.php.

    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

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