Configurer un projet de console Google APIs pour l'API Google Ads

Vous devez fournir des identifiants pour accéder aux serveurs OAuth2 de Google afin d'authentifier et d'autoriser les utilisateurs Google Ads. Ces identifiants identifient votre application auprès de Google, ce qui vous permet de générer des jetons OAuth pour gérer les utilisateurs Google Ads. L'accès aux identifiants Google OAuth2 est géré depuis la console Google APIs.

Regardez cette vidéo pour connaître les bonnes pratiques concernant les projets Cloud

Validation Google OAuth

Toute application Google Cloud utilisée pour obtenir des identifiants pour le champ d'application de l'API Google Ads devra être soumise à une validation Google OAuth afin d'éviter que ses utilisateurs ne voient un écran d'interface utilisateur non validé. Dans ce contexte, une application est définie comme un ID client OAuth 2.0 unique dans Google Cloud.

Cette validation est indépendante et s'ajoute à tous les examens effectués dans le cadre du processus d'approbation des jetons de développeur. Elle est obligatoire puisque le champ d'application de l'API Google Ads est un champ d'application sensible.

La validation par Google est sans frais, qui prend généralement trois à cinq jours ouvrés. Ce règlement s'applique à toutes les applications.

Nous vous recommandons de soumettre toutes vos applications à la procédure de validation Google OAuth dès que possible afin d'éviter toute interruption de service.

Créer un projet

Accédez à la console Google APIs. Cliquez sur Créer un projet, saisissez un nom, puis cliquez sur Créer.

Point clé :Si la facturation est activée (pour Google Cloud, par exemple), vous devez sélectionner un compte de facturation pour le nouveau projet.

L'utilisation de l'API Google Ads est sans frais, mais elle est soumise à un quota sur le nombre total de projets Cloud. Vous pouvez également créer un compte Google qui inclut un quota sans frais pour les projets.

Activer l'API Google Ads dans votre projet

Pour activer l'API Google Ads pour votre projet, procédez comme suit:

1. Ouvrez la bibliothèque d'API dans la console Google APIs. Si vous y êtes invité, sélectionnez votre projet ou créez-en un. La bibliothèque d'API répertorie toutes les API disponibles, regroupées par famille de produits et par popularité.

2. Utilisez la recherche pour trouver l'API Google Ads si elle n'apparaît pas dans la liste.

3. Sélectionnez l'API Google Ads, puis cliquez sur le bouton Activer.

Choisir un type d'utilisateur et l'état de publication

Après avoir activé l'API, vous devez spécifier le type d'utilisateur et l'état de publication de votre projet. Le tableau suivant met en évidence certains attributs clés et limites de chaque combinaison de ces paramètres. Pour en savoir plus, consultez la documentation de Google Cloud Platform.

Type d'utilisateur	État de la publication	Limites
Interne	Tests	Disponible uniquement pour les projets associés à une organisation Google Cloud. Limité à un maximum de 100 utilisateurs de test listés sur l'écran de consentement OAuth. Les utilisateurs test doivent être des utilisateurs internes de l'organisation Google Cloud associée au projet. Les autorisations expirent sept jours à compter de la date d'obtention du consentement.
Externe	Tests	Disponible pour tous les projets. Limité à un maximum de 100 utilisateurs de test listés sur l'écran de consentement OAuth. Il peut s'agir de n'importe quel utilisateur disposant d'un compte Google. Les autorisations expirent sept jours à compter de la date d'obtention du consentement.
Interne	En production	Disponible uniquement pour les projets associés à une organisation Google Cloud. Autorise tout utilisateur de l'organisation Google Cloud associé au projet.
Externe	En production	Disponible pour tous les projets. Autorise tout utilisateur disposant d'un compte Google.

Si vous ne terminez pas la validation Google OAuth, les problèmes suivants se produisent, quel que soit le type d'utilisateur ou l'état de publication de votre projet:

• Au cours du processus d'autorisation, un écran d'interface utilisateur non validé s'affiche.

• Vous êtes limité à 100 utilisateurs.

Configurer l'écran de consentement OAuth

1. Ouvrez la page Écran de consentement et sélectionnez votre projet dans le menu déroulant en haut de la page.

2. Sélectionnez le type d'utilisateur, puis cliquez sur CRÉER.

3. Remplissez le formulaire de l'écran de consentement. Vous pourrez les modifier plus tard si nécessaire. Lorsque vous avez terminé, cliquez sur ENREGISTRER ET CONTINUER.

4. Sur la page suivante, cliquez sur AJOUTER OU SUPPRIMER DES CHAMPS D'APPLICATION.

   • Faites défiler la page vers le bas et saisissez les informations suivantes dans le champ situé sous Ajouter manuellement des niveaux d'accès:

     https://www.googleapis.com/auth/adwords
     

   • Cliquez sur AJOUTER À LA TABLE.

   • Ajoutez tous les autres niveaux d'accès demandés par votre projet, puis cliquez sur METTRE À JOUR.

   • Cliquez sur SAVE AND CONTINUE (ENREGISTRER ET CONTINUER).

5. Si vous ne prévoyez pas de publier votre projet immédiatement, ajoutez l'adresse e-mail de chaque compte utilisateur que vous utiliserez pour les tests, puis cliquez sur ENREGISTRER ET CONTINUER.

6. Consultez la page de résumé, puis cliquez sur RETOUR AU TABLEAU DE BORD.

Une fois que vous avez testé votre application et le processus d'autorisation, vous pouvez revenir au tableau de bord et cliquer sur PUBLIER L'APPLICATION pour modifier l'état de publication de Test à En production.

Sélectionnez un type d'application

Il existe deux types d'applications pour l'API Google Ads: ordinateur ou Web. Consultez le tableau suivant pour déterminer le type le plus approprié pour l'application que vous souhaitez compiler:

Choisir ce type d'application	si...
Application de bureau	Vous gérez tous vos comptes Google Ads à l'aide d'un seul compte administrateur de niveau supérieur. Vous êtes un nouvel utilisateur ou vous souhaitez commencer rapidement avec la configuration la plus simple. Votre application n'authentifie les utilisateurs Google que depuis une seule machine.
Application Web	Vous souhaitez vous authentifier en tant qu'utilisateur pouvant autoriser votre application à accéder aux données de son compte Google Ads. Vous souhaitez générer facilement plusieurs identifiants d'autorisation pour gérer des comptes tiers, par exemple. Votre application nécessite des URL de rappel. Ces URL ne sont pas compatibles avec le flux d'applications de bureau.

Important :Vous pouvez toujours choisir le parcours d'application de bureau, même si vous développez une application à exécuter sur un serveur. La différence réside dans le fait que l'autorisation OAuth est effectuée localement ou à distance. Un flux pour ordinateur nécessite une autorisation sur la machine locale, tandis que le flux Web permet d'effectuer une autorisation sur le serveur d'autorisation de Google.

Pour en savoir plus, consultez la documentation OAuth de Google Identity Platform pour les applications de bureau ou les applications Web.

Créer un ID client et un code secret du client

Une fois que vous avez déterminé votre type d'application, suivez les instructions ci-dessous pour générer l'ID et le code secret du client OAuth2:

1. Ouvrez la page Identifiants. Sélectionnez un projet créé précédemment ou créez-en un.

2. Sur l'écran "Identifiants", cliquez sur CRÉER DES IDENTIFIANTS, puis sélectionnez ID client OAuth.

   1. Si vous n'avez pas encore configuré d'écran de consentement OAuth pour ce projet, vous serez invité à le faire maintenant. Cliquez sur CONFIGURER L'ÉCRAN D'AUTORISATION.

      1. Sélectionnez le type d'utilisateur, puis cliquez sur CRÉER.

      2. Remplissez le formulaire initial. Vous pourrez les modifier plus tard si nécessaire. Lorsque vous avez terminé, cliquez sur Enregistrer.

   2. Revenez à Identifiants > CRÉER DES IDENTIFIANTS > ID client OAuth pour continuer.

3. Sélectionnez Application de bureau ou Application Web comme type d'application, selon votre cas d'utilisation.

4. Donnez-lui un nom, puis cliquez sur Créer.

5. Si votre type de client est Application Web, ajoutez au moins un URI de redirection autorisé.

   Pour les tests en local compatibles avec la configuration par défaut dans nos exemples de bibliothèques clientes, utilisez http://127.0.0.1.

   Remarque :Vous pouvez ajouter un numéro de port à votre URI de redirection pour limiter l'utilisation à un port spécifique. Si le port n'est pas défini, un client OAuth peut rediriger vers n'importe quel port.

   Pour les clients d'applications de bureau, vous utiliserez toujours une redirection IP de bouclage, mais l'URI n'est pas explicitement configuré dans la console Cloud.

6. Sur la page de confirmation, copiez Your Client ID (Votre ID client) et Your Client Secret (Code secret de votre client) dans votre presse-papiers, car vous en aurez besoin pour configurer votre bibliothèque cliente. Vous pouvez également revenir à la page des identifiants ultérieurement pour récupérer ces informations.