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

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

Regardez cette vidéo pour découvrir quelques 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 doit : de suivre un processus d'authentification la validation pour éviter un écran d'UI non validé pour ses utilisateurs. Dans ce contexte, une application est définie comme un ID client OAuth 2.0 unique. dans Google Cloud.

Cette vérification est indépendante et s'ajoute aux examens réalisés lors du processus d'approbation des jetons de développeur, et est obligatoire, car le champ d'application de l'API Google Ads est un élément sensible le champ d'application.

La validation Google n'entraîne aucuns frais, qui s'effectue généralement en trois ou 5 jours ouvrés. Cette règle s'applique à toutes les applications.

Nous recommandons que toutes les applications soient soumises à la procédure de validation Google OAuth dès que possible que possible pour éviter toute interruption d'activité.

Créer un projet

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

Important :Si la facturation est activée, pour Google Cloud pour Vous devez alors sélectionner un compte de facturation pour le nouveau projet.

L'utilisation de l'API Google Ads est sans frais, mais un quota est appliqué au total le nombre de projets Cloud. Vous pouvez également vous inscrire à un nouveau compte Compte qui inclut un quota de projets sans frais.

Activer l'API Google Ads dans votre projet

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

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

2. Utilisez la recherche pour trouver l'API Google Ads si elle ne figure pas dans la liste.

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

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

Une fois l'API activée, vous devez spécifier les paramètres User type (Type d'utilisateur) de votre projet et État de la publication. Le tableau suivant met en évidence certains attributs clés et les limites de chaque combinaison de ces paramètres. Pour en savoir plus, consultez le cours Google Cloud Platform documentation.

Type d'utilisateur	État de la publication	Limites
Interne	Tests	Disponible uniquement pour les projets associés à un Organisation. Limité à 100 utilisateurs tests listés dans l'autorisation OAuth l'écran. Les utilisateurs de test doivent être des utilisateurs internes dans Google Cloud Organisation associée au projet. Les autorisations expirent sept jours à compter de la date de consentement.
Externe	Tests	Disponible pour tous les projets. Limité à 100 utilisateurs tests listés dans l'autorisation OAuth l'écran. Les utilisateurs tests peuvent être n'importe quel utilisateur disposant d'un compte Google. Les autorisations expirent sept jours à compter de la date de consentement.
Interne	En production	Disponible uniquement pour les projets associés à un Organisation. Permet d'autoriser n'importe quel utilisateur au sein de l'organisation Google Cloud associées au projet.
Externe	En production	Disponible pour tous les projets. Permet d'autoriser tout utilisateur disposant d'un compte Google.

L'authentification Google OAuth validation génère les résultats suivants, quel que soit le type d'utilisateur ou le niveau de publication l'état d'avancement de votre projet:

• Au cours du processus d'autorisation, les utilisateurs voient s'afficher une interface utilisateur non validée. écran.

• Vous êtes limité à 100 utilisateurs.

Configurer l'écran d'autorisation OAuth

1. Ouvrez le 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 et cliquez sur CRÉER.

3. Remplissez le formulaire de l'écran de consentement. Vous pourrez le modifier plus tard si nécessaire. Cliquez sur 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, puis saisissez ce qui suit dans le champ situé sous Ajouter manuellement champs d'application :

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

   • Cliquez sur AJOUTER AU TABLEAU.

   • Ajoutez tous les autres champs d'application que votre projet demandera, 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 le test, puis cliquez sur ENREGISTRER ET CONTINUER.

6. Examinez la page de synthèse, puis cliquez sur RETOUR AU TABLEAU DE BORD.

Après avoir testé votre application et le processus d'autorisation, vous pouvez retournez au tableau de bord et cliquez sur PUBLIER L'APPLICATION pour modifier ses publications. d'état de Tests à En production.

Sélectionnez un type d'application

Il existe deux types d'applications pour l'API Google Ads : "Ordinateur" et "Web". Consultez le tableau suivant pour déterminer le type le mieux adapté à l'application que vous souhaitez créer:

Sélectionner ce type d'appli	si...
Application de bureau	Vous gérez tous vos comptes Google Ads à l'aide d'un seul niveau racine de votre compte administrateur. Vous êtes un nouvel utilisateur ou vous souhaitez vous lancer rapidement configuration. Votre application n'authentifie les utilisateurs Google que depuis une seule machine.
Application Web	Vous souhaitez vous authentifier en tant qu'utilisateur pouvant accorder l'autorisation à votre application pour accéder aux données de leur compte Google Ads. Vous souhaitez générer facilement plusieurs identifiants d'autorisation afin de gérer des comptes tiers, par exemple. Votre application nécessite des URL de rappel. Les URL de rappel ne sont pas acceptées dans le le flux de l’application de bureau.

Important :Vous pouvez toujours choisir le flux de l'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 effectuées localement ou à distance. Un flux de bureau nécessite une autorisation effectué sur la machine locale, alors que le flux web permet d'autoriser effectuée sur le serveur d'autorisation de Google.

Pour en savoir plus, consultez la documentation OAuth sur Google Identity Platform des applications de bureau ou 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 "Credentials" (Identifiants), cliquez sur CREATE CREDENTIALS (CRÉER DES IDENTIFIANTS), puis sélectionnez OAuth ID client.

   1. Si vous n'aviez pas configuré d'écran de consentement OAuth pour ce projet auparavant, 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 le modifier plus tard si nécessaire. Cliquez sur Lorsque vous avez terminé, cliquez sur Enregistrer.

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

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

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

5. Si votre type de client est Application Web, ajoutez au moins une application l'URI de redirection.

   Pour les tests en local compatibles avec la configuration par défaut dans notre 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 quelle adresse .

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

6. Sur la page de confirmation, copiez votre ID client et votre code secret du client. dans le presse-papiers, car vous en aurez besoin pour configurer votre client bibliothèque. Vous pouvez également revenir ultérieurement à la page des identifiants pour les récupérer. plus de détails.