OAuth Playground

Vous pouvez également générer des identifiants OAuth2 à l'aide d'OAuth2 Playground. OAuth2 Playground, conjointement avec la console Google APIs, vous permet de créer manuellement des jetons OAuth2.

OAuth2 Playground est destiné aux utilisateurs qui n'ont besoin d'accéder qu'aux comptes d'un seul compte administrateur ou utilisateur Google Ads. Si vous devez demander des identifiants à plusieurs utilisateurs, il est probablement préférable de configurer une bibliothèque cliente pour OAuth dans l'API Google Ads.

Obtenir un ID client et un code secret client

Avertissement : Pour utiliser OAuth2 Playground, vous devez générer un ID client pour une application Web. Il s'agit du seul type d'application qui fonctionne avec OAuth2 Playground. Pour en savoir plus, consultez la section Sélectionner un type d'application.

Si vous n'avez pas de projet Cloud existant :

1. Ouvrez la page Identifiants de la console Google APIs.

2. Dans le menu déroulant des projets, sélectionnez un projet existant ou créez-en un.

3. Sur la page "Identifiants", sélectionnez Créer des identifiants, puis ID client OAuth.

4. Sous Type d'application, sélectionnez Application Web.

5. Sous URI de redirection autorisés, ajoutez une ligne avec les éléments suivants : https://developers.google.com/oauthplayground

6. Cliquez sur Créer.

7. Sur la page d'ID client, notez l'ID client et le code secret du client. Vous en aurez besoin à l'étape suivante.

Si vous disposez d'un projet cloud existant, vous pouvez le réutiliser en définissant les URI de redirection autorisés, comme décrit à l'étape 5.

Générer des jetons

Avertissement : L'utilisateur Google avec lequel vous êtes connecté dans votre navigateur détermine les comptes Google Ads auxquels vous pourrez accéder avec les identifiants OAuth2 que vous générez. Par conséquent, nous vous recommandons de suivre ces étapes dans une fenêtre de navigation privée ou lorsque vous n'êtes pas connecté à votre compte Google, car il est probable que l'utilisateur dont vous souhaitez utiliser les identifiants ne soit pas le même que celui avec lequel vous étiez connecté lorsque vous avez obtenu l'ID client et le secret.

1. Accédez à OAuth2 Playground (l'utilisation de ce lien devrait préremplir certaines valeurs clés).

2. Cliquez sur l'icône en forme de roue dentée dans l'angle supérieur droit, puis cochez la case Use your own OAuth credentials (Utiliser vos propres identifiants OAuth) si ce n'est pas déjà fait.

3. Faites les vérifications suivantes :

   • OAuth flow (flux OAuth) est défini sur Server-side (côté serveur) ;
   • Le type d'accès est défini sur Hors connexion (vous obtenez ainsi un jeton d'actualisation et un jeton d'accès, au lieu d'un seul jeton d'accès).

4. Saisissez l'ID client OAuth2 et le code secret du client OAuth2 que vous avez obtenus ci-dessus.

   

5. Dans la section Étape 1 – Sélectionner et autoriser des API, cliquez sur API Google Ads dans la liste, puis sélectionnez son champ d'application, https://www.googleapis.com/auth/adwords. Cliquez ensuite sur Authorize APIs (Autoriser les API).

   

6. Si vous y êtes invité, connectez-vous au compte auquel vous souhaitez accorder l'accès et l'autorisation. Sinon, vérifiez que l'utilisateur Google actuel en haut à droite correspond au compte Google Ads ou administrateur pour lequel vous souhaitez obtenir des identifiants.

   Si vous avez obtenu votre ID client et votre secret il y a seulement quelques minutes et que vous recevez une erreur telle que Error: redirect_uri_mismatch (Erreur : redirect_uri_mismatch), il est possible que les modifications que vous avez apportées ne se soient pas propagées. Cliquez sur le bouton "Retour" de votre navigateur, patientez quelques minutes, puis réessayez de cliquer sur Authorize APIs (Autoriser les API).
   Si vous recevez un message d'erreur indiquant que l'accès ne vous a pas été accordé par le développeur et que l'application est en cours de test, vous devez accéder à la page de l'écran de consentement OAuth de votre projet GCP et effectuer l'une des opérations suivantes:

   • Publiez l'application.

   • Laissez l'application en cours de test et ajoutez-vous en tant qu'utilisateur test.

7. Une invite s'affiche pour indiquer que votre application souhaite gérer vos campagnes Google Ads. Cliquez sur Accepter pour continuer.

8. Dans l'onglet Étape 2 : Échanger le code d'autorisation contre des jetons, un code d'autorisation doit apparaître. Cliquez sur Exchange authorization code for tokens (Échanger le code d'autorisation contre des jetons).

   

9. Si tout se passe bien, les champs Refresh token (Jeton d'actualisation) et Access token (Jeton d'accès) devraient être renseignés à votre place (vous devrez peut-être développer à nouveau l'étape 2 : Échanger le code d'autorisation contre des jetons) :

   

10. Copiez le jeton d'actualisation dans le fichier de configuration de la bibliothèque cliente de votre choix, ainsi que l'ID client et le code secret du client.

11. Configurez une bibliothèque cliente pour OAuth dans l'API Google Ads.

Supprimer le bac à sable OAuth2 de votre ID client

Maintenant que vous disposez d'un jeton d'actualisation, vous n'avez plus besoin que OAuth2 Playground soit un URI de redirection autorisé. Pour le supprimer de la liste des URI de redirection autorisés :

1. Accédez à la page Identifiants de la console Google APIs.

2. Dans le menu déroulant des projets, sélectionnez votre projet.

3. Sur la page "Identifiants", cliquez sur le nom de l'ID client à modifier.

4. Supprimez https://developers.google.com/oauthplayground des URI de redirection autorisés. Notez que vous devez conserver au moins un URI de redirection en place.

5. Cliquez sur Enregistrer.