Flux OAuth des applications de bureau et Web

Avertissement:À compter du 31 mars 2024, la bibliothèque cliente de l'API Google Ads pour PHP ne sera plus compatible avec les versions de PHP antérieures à la version 8.1. Pour assurer un fonctionnement fluide, nous vous recommandons vivement de mettre à niveau votre version de PHP avant cette date.

Ce guide vous explique comment configurer OAuth2 pour l'accès à l'API à l'aide de vos propres identifiants et du flux pour ordinateur ou du flux Web. Cette procédure ne doit être effectuée qu'une seule fois, sauf si vous révoquez, supprimez ou modifiez les champs d'application autorisés pour vos identifiants OAuth2.

Créer des identifiants OAuth2

1. Suivez les étapes pour configurer un projet de console Google APIs pour l'API Google Ads.

2. Notez l'ID client et le code secret, puis revenez sur cette page.

Configurez la bibliothèque cliente

1. Dans un terminal, exécutez l'exemple GenerateUserCredentials, qui vous invite à saisir votre ID client et votre code secret OAuth2.

   Il s'agit d'un exemple interactif qui nécessitera une entrée.

   php GenerateUserCredentials.php
   

2. Dans l'exemple, vous êtes invité à accéder à une URL pour laquelle vous devez autoriser les identifiants OAuth2 à accéder à votre compte Google Ads en votre nom.

   Paste this URL in your browser:
   https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...
   

   Accédez à l'URL dans une session de navigateur privée ou dans une fenêtre de navigation privée. Connectez-vous avec le compte Google que vous utilisez pour accéder à Google Ads. Cliquez sur Continuer sur l'écran de consentement OAuth2.

   

3. Vous êtes ensuite redirigé vers une page affichant un message indiquant que l'autorisation a réussi.

   Votre jeton d'actualisation a été récupéré. Pour plus d'informations, consultez la sortie de la console.

4. Revenez à la console dans laquelle vous avez exécuté l'exemple. L'exemple doit se terminer et afficher votre jeton d'actualisation et quelques instructions, suivi des propriétés dont vous aurez besoin pour configurer la bibliothèque cliente:

   Your refresh token is: 1/Yw**********
   Copy the text below into a file named "google_ads_php.ini" in your home directory, and replace "INSERT_DEVELOPER_TOKEN_HERE" with your developer token:
   
   [GOOGLE_ADS]
   developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
   [OAUTH2]
   Copy the following lines to your 'google_ads_php.ini' file:
   clientId = "***********************apps.googleusercontent.com"
   clientSecret = "****"
   refreshToken = "****"