Les identifiants d'accès aux serveurs OAuth2 de Google sont requis pour authentifier et 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 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 devra être soumise à une validation Google OAuth afin d'éviter l'affichage d'un écran d'interface utilisateur 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 validation est indépendante et s'ajoute aux examens effectués dans le cadre du processus d'approbation des jetons de développeur. Elle est obligatoire, car le champ d'application de l'API Google Ads est un champ d'application sensible.
La validation Google n'entraîne aucuns frais, qui prend généralement entre trois et cinq jours ouvrés. Cette règle s'applique à toutes les applications.
Nous vous recommandons de soumettre toutes les applications à la procédure de validation Google OAuth dès que possible pour é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.
Activer l'API Google Ads dans votre projet
Pour activer l'API Google Ads pour votre projet, procédez comme suit:
Dans la console Google APIs, ouvrez la bibliothèque d'API. 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é.
Utilisez la recherche pour trouver l'API Google Ads si elle ne figure pas dans la liste.
Sélectionnez l'API Google Ads, puis cliquez sur le bouton Activer.
Choisir un type d'utilisateur et un é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 présente 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 | Test |
|
Service | Test |
|
Interne | En production |
|
Service | En production |
|
Si vous ne terminez pas la validation Google OAuth, cela aura les conséquences suivantes, 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ée s'affiche.
Vous êtes limité à 100 utilisateurs.
Configurer l'écran de consentement OAuth
Ouvrez la page Consent Screen (Écran de consentement), puis sélectionnez votre projet dans le menu déroulant en haut de la page.
Sélectionnez le type d'utilisateur et cliquez sur CRÉER.
Remplissez le formulaire de l'écran de consentement. Vous pourrez le modifier plus tard si nécessaire. Lorsque vous avez terminé, cliquez sur ENREGISTRER ET CONTINUER.
Sur la page suivante, cliquez sur AJOUTER OU SUPPRIMER DES CHAMPS D'APPLICATION.
Faites défiler la page vers le bas et saisissez la commande suivante dans le champ Ajouter manuellement des 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).
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.
Examinez la page de synthèse, 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 PUBLISH APP (PUBLIER L'APPLICATION) pour passer de l'état de publication Test à In production (En production).
Sélectionnez un type d'application
Il existe deux types d'applications pour l'API Google Ads : "Ordinateur" et "Web". Reportez-vous au tableau suivant pour déterminer le type le plus approprié pour l'application que vous souhaitez compiler:
Sélectionner ce type d'appli | si... |
---|---|
Application de bureau |
|
Application Web |
|
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:
Ouvrez la page Identifiants. Sélectionnez un projet créé précédemment ou créez-en un.
Sur l'écran "Identifiants", cliquez sur CRÉER DES IDENTIFIANTS, puis sélectionnez ID client OAuth.
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.
Sélectionnez le type d'utilisateur, puis cliquez sur CRÉER.
Remplissez le formulaire initial. Vous pourrez le modifier plus tard si nécessaire. Cliquez sur Save (Enregistrer) lorsque vous avez terminé.
Revenez à Identifiants > CRÉER DES IDENTIFIANTS > ID client OAuth pour continuer.
Sélectionnez Application de bureau ou Application Web comme type d'application, selon votre cas d'utilisation.
Attribuez-lui un nom, puis cliquez sur Créer.
Si votre type de client est une application Web, ajoutez au moins un URI de redirection autorisé.
Pour les tests en local compatibles avec la configuration par défaut de nos exemples de bibliothèques clientes, utilisez
http://127.0.0.1
.Pour les clients d'application de bureau, vous utiliserez toujours une redirection d'adresse IP de bouclage, mais l'URI n'est pas explicitement configuré dans la console Cloud.
Sur la page de confirmation, copiez Your Client ID (Votre ID client) et Your Client Secret (Code secret du 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.