OAuth Playground

Une option pour générer des identifiants OAuth2 consiste à utiliser le Playground OAuth2. OAuth2 Playground, conjointement avec la console API Google Ads, 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 d'un utilisateur Google Ads. Si vous devez inviter plusieurs utilisateurs à saisir leurs identifiants, il est probablement préférable de configurer une bibliothèque cliente pour OAuth dans Search Ads 360.

Obtenir un ID client et un code secret du 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 Choisir un type d'application.

Si vous ne disposez d'aucun projet Cloud, procédez comme suit:

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

2. Dans la liste déroulante 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 contenant : https://developers.google.com/oauthplayground

6. Cliquez sur Créer.

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

Si vous disposez déjà d'un projet Cloud, vous pouvez le réutiliser en définissant les URI de redirection autorisés comme ci-dessus.

Générer des jetons

Avertissement :L'utilisateur Search Ads 360 avec lequel vous êtes connecté dans votre navigateur détermine les comptes auxquels vous pouvez accéder à l'aide des identifiants OAuth2 que vous générez. Par conséquent, vous pouvez effectuer ces étapes dans une fenêtre de navigation privée ou lorsque vous n'êtes pas connecté à votre compte Search Ads 360, car il est probable que l'utilisateur dont vous souhaitez utiliser les identifiants ne corresponde pas à celui auquel vous étiez connecté lorsque vous avez obtenu l'ID client et le code secret.

1. Accédez au Playground OAuth2 (ce lien devrait vous permettre de préremplir certaines valeurs de clé).

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 êtes ainsi certain d'obtenir un jeton d'actualisation et un jeton d'accès au lieu d'un simple 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 intitulée Étape 1 – Sélectionner et autoriser des API, cliquez sur API Search Ads 360 Reporting dans la liste et sélectionnez son champ d'application, https://www.googleapis.com/auth/doubleclicksearch. 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 actuel, en haut à droite, correspond au compte client ou administrateur pour lequel vous souhaitez obtenir des identifiants.

   Si vous avez obtenu votre ID client et votre code secret il y a quelques minutes, et que vous obtenez une erreur telle que Error: redirect_uri_mismatch, il est possible que les modifications que vous avez apportées n'aient pas été 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 à l'état "Test", puis ajoutez-vous en tant qu'utilisateur test.

7. Une invite s'affiche pour indiquer que votre application souhaite gérer vos campagnes Search Ads 360. 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 déroule comme prévu, les champs Jeton d'actualisation et Jeton d'accès doivent être renseignés automatiquement (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, accompagné de l'ID client et du code secret du client.

11. Configurez une bibliothèque cliente pour OAuth dans l'API Search Ads 360 Reporting.

Supprimer OAuth2 Playground 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 la supprimer de la liste des URI de redirection autorisés, procédez comme suit:

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

2. Dans la liste déroulante du projet, 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.