Les étapes à suivre pour créer et configurer un projet dans la console Google APIs dépendent du type de scénario d'autorisation OAuth 2.0 que vous créez dans votre application. Choisissez le scénario d'autorisation pour lequel vous créez un code. Ce guide sera personnalisé en fonction de votre choix.
Vous avez besoin d'un projet dans la console Google APIs pour créer des identifiants OAuth 2.0 et activer l'API Google Ads pour votre application.
Ces identifiants sont nécessaires pour l'authentification et l'autorisation des utilisateurs Google Ads par les serveurs Google. Ces identifiants vous permettent de générer des jetons OAuth à utiliser dans les appels à l'API.
Sélectionner ou créer un projet dans la console Google APIs
Suivez les instructions pour créer un projet. L'activation de la facturation pour votre projet est facultative. Si la facturation est activée, sélectionnez un compte de facturation pour le nouveau projet. L'utilisation de l'API Google Ads est sans frais, mais il existe un quota sur le nombre total de projets Cloud.
Activer l'API Google Ads dans votre projet
Pour activer l'API Google Ads dans 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 classées en fonction de leur popularité.
Utilisez la recherche pour trouver l'API Google Ads si elle n'apparaît pas dans la liste.
Sélectionnez l'API Google Ads, puis cliquez sur le bouton Activer.
Demander l'accès à l'API
Ensuite, accédez à la page Présentation de l'API Google Ads. La page affiche votre niveau d'accès actuel à l'API. Si votre niveau d'accès à l'API actuel est Accès test, développez la section Demander le niveau d'accès suivant. Suivez les instructions pour demander le niveau d'accès Explorateur.
Une fois votre demande finalisée, Google l'examinera automatiquement et, dans la plupart des cas, vous accordera l'accès Explorateur.
Configurer l'écran d'autorisation OAuth
Lorsque vous utilisez OAuth 2.0 pour gérer les autorisations, Google présente à l'utilisateur un écran de consentement, qui montre un récapitulatif de votre projet, des règles qui s'y appliquent et les champs d'application d'autorisation d'accès demandés. La configuration de l'écran de consentement OAuth de votre application définit ce qui est affiché aux utilisateurs et aux évaluateurs d'applications, et enregistre votre application pour que vous puissiez la publier ultérieurement.
Suivez les instructions pour configurer un écran de consentement OAuth pour votre application et ajouter https://www.googleapis.com/auth/adwords en tant que champ d'application OAuth.
Points importants concernant le type d'utilisateur et l'état de publication
Lorsque vous configurez l'écran de consentement OAuth, faites attention aux paramètres Type d'utilisateur et État de publication.
- Type d'utilisateur : indique si votre application est limitée aux utilisateurs de votre organisation ("Interne") ou si elle est disponible pour tous les utilisateurs Google ("Externe"). Notez que l'option "Interne" n'est disponible que si votre projet fait partie d'une organisation Google Workspace.
- État de publication : détermine si l'application est en mode "Test" (limitée à des utilisateurs tests spécifiques que vous ajoutez) ou "En production" (disponible pour l'audience définie par le type d'utilisateur, ce qui peut nécessiter une vérification de l'application par Google).
Pour faire les meilleurs choix pour votre application, consultez les explications détaillées et les implications de ces paramètres dans la documentation d'assistance officielle Google Cloud :
- Options de type d'utilisateur pour l'écran de consentement OAuth
- Options d'état de publication de l'écran de consentement OAuth
Il est essentiel de comprendre ces paramètres pour vous assurer que votre application est accessible aux utilisateurs que vous ciblez.
Créer un ID client et un code secret client
Vous pouvez ignorer cette étape si vous utilisez un projet de console Google APIs existant qui possède déjà un ID client et un code secret client générés. Dans le cas contraire, créez un ID client et un code secret de client en suivant les instructions. Vous pouvez choisir Application de bureau ou Application Web comme type d'application. Une fois le client OAuth 2.0 créé, téléchargez son fichier JSON en cliquant d'abord sur l'icône Télécharger le client OAuth, puis sur le bouton TÉLÉCHARGER AU FORMAT JSON sur l'écran suivant.