Le jeton de développeur est une chaîne alphanumérique de 22 caractères qui permet à votre application de se connecter à l'API Google Ads. Vous pouvez en obtenir un en vous inscrivant sur la page Centre API de votre compte administrateur Google Ads. Chaque fois que vous effectuez un appel d'API, vous envoyez le jeton de développeur dans le cadre de la requête en définissant l'en-tête HTTP ou gRPC developer-token.
Chaque jeton de développeur est associé à un niveau d’accès qui contrôle le nombre d’appels d’API que vous pouvez effectuer par jour avec le jeton, ainsi que l’ environnement dans lequel vous pouvez effectuer des appels.
Lorsque vous vous inscrivez pour obtenir un jeton de développeur, vous pouvez obtenir le niveau d'accès Explorateur par défaut. Cela vous permet d'effectuer des appels sur des comptes de production, mais avec certaines restrictions. Dans certains cas où nous ne sommes pas en mesure d'examiner automatiquement votre demande de jeton de développeur, nous pouvons attribuer à votre jeton de développeur un niveau d'accès au compte de test. Cela vous permet d'effectuer des appels d'API uniquement sur des comptes de test. Pour supprimer les restrictions des niveaux d'accès Explorateur et Compte de test, vous devez demander le niveau d'accès de base ou le niveau d'accès standard pour votre jeton de développeur. Une fois votre demande de jeton de développeur examinée et approuvée, le niveau d'accès approprié sera attribué à votre jeton de développeur.
Avez-vous besoin d'un nouveau jeton de développeur ?
La nécessité de vous inscrire pour obtenir un nouveau jeton de développeur dépend de plusieurs facteurs. Voici plusieurs scénarios courants :
Scénario |
Étapes suivantes |
| Votre entreprise n'a jamais utilisé l'API Google Ads et vous souhaitez développer vos propres applications | Inscrivez-vous pour obtenir un nouveau jeton de développeur. En savoir plus |
| Votre entreprise utilise ou a utilisé l'API Google Ads | Google n'accorde généralement qu'un seul jeton de développeur par entreprise. Si votre entreprise utilise déjà l'API Google Ads, vous devez réutiliser votre jeton de développeur existant. En savoir plus |
| Votre entreprise utilise déjà l'API Google Ads, mais développe également un nouveau produit ou outil | Si vous êtes certain de ne pas pouvoir utiliser votre jeton de développeur existant, alors vous pouvez en demander un nouveau en expliquant votre cas d'utilisation dans la demande. Pour le reste de ce guide, vous pouvez utiliser votre jeton de développeur existant. En savoir plus |
| Votre entreprise utilise une application tierce | Vous n'avez besoin d'un jeton de développeur que si vous développez votre propre application. Si vous utilisez une application ou un service tiers, le développeur de cette application doit obtenir un jeton de développeur pour l'application. Si vous n'êtes pas sûr de votre cas, contactez l'équipe chargée de la conformité de l'API. |
Qui peut demander un jeton de développeur ?
Les entreprises et les développeurs individuels peuvent demander un jeton de développeur. Le tableau suivant récapitule les informations que vous devez fournir lorsque vous vous inscrivez pour obtenir le jeton de développeur.
| Si vous êtes | Fournissez les informations suivantes sur le développeur | Remarques supplémentaires |
|---|---|---|
| Un développeur représentant votre entreprise ou une équipe produit | Le nom et l'URL de votre entreprise | Google n'accorde généralement qu'un seul jeton de développeur par entreprise, mais approuve des jetons de développeur distincts pour des outils distincts au cas par cas. |
| Un développeur individuel ne représentant pas une entreprise | Spécifiez le nom de votre entreprise comme Individual. Vous pouvez
fournir d'autres URL, telles que l'URL de votre profil GitHub ou LinkedIn,
au lieu d'une URL d'entreprise. |
Vous devez disposer d'une présence en ligne et fournir à Google une URL
qui nous aide à évaluer ce que vous prévoyez de faire avec l'API Google Ads. Les URL génériques
telles que test.com et example.com ne sont pas
acceptées. |
Demander un jeton de développeur
La demande de jeton de développeur s'effectue en deux étapes.
Étape 1 : Sélectionner ou créer un compte administrateur Google Ads
Si vous possédez déjà un compte administrateur Google Ads, sélectionnez-le lorsque vous demandez le jeton de développeur. Si ce compte administrateur n'est pas déjà associé à vos autres comptes, nous vous recommandons de le placer à la racine de votre hiérarchie de comptes pour faciliter le processus d'examen du jeton et simplifier la gestion des comptes par la suite.
Si vous ne possédez pas de compte administrateur, vous pouvez suivre les instructions du centre d'aide pour en créer un.
Étape 2 : Demander l'accès à l'API Google Ads
Notez que le processus d'examen du jeton de développeur peut prendre un certain temps. En savoir plus.
Accédez à https://ads.google.com/aw/apicenter dans votre navigateur Web. Si vous y êtes invité, connectez-vous à votre compte administrateur Google Ads.
Remplissez le formulaire d'accès à l'API et acceptez les conditions d'utilisation.
Assurez-vous que vos informations sont correctes et que l'URL du site Web de votre entreprise fonctionne. Si le site Web n'est pas en ligne, Google peut ne pas être en mesure de traiter votre demande et la refuser.
Assurez-vous que l'adresse e-mail de contact de l'API que vous fournissez mène à une boîte de réception surveillée régulièrement. L'équipe chargée de la conformité de l'API de Google peut contacter cette adresse e-mail lors du processus d'examen pour obtenir des clarifications. Si nous ne parvenons pas à vous joindre, Google peut ne pas poursuivre votre demande.
Vous pouvez modifier votre adresse e-mail de contact de l'API dans le centre API. Maintenez ces informations à jour, même après le processus de demande, afin que Google puisse vous envoyer des annonces importantes sur le service.
Une fois le processus de demande terminé, le jeton de développeur s'affiche dans votre centre API avec l'un des résultats suivants :
- Votre jeton de développeur dispose du niveau d'accès Explorateur avec l'état Approuvé. Cela signifie que Google a pu examiner et approuver automatiquement votre demande de jeton de développeur pour le niveau d'accès Explorateur. Vous pouvez commencer à effectuer des appels d'API sur votre compte de production ou votre compte de test.
- Votre jeton de développeur dispose du niveau d'accès au compte de test avec l'état Approbation en attente. Cela signifie que Google n'a pas pu examiner et approuver automatiquement votre demande de jeton de développeur pour le niveau d'accès Explorateur. Vous pouvez commencer à effectuer des appels d'API sur des comptes de test. Une fois ce guide terminé, nous vous encourageons à découvrir comment demander le niveau d'accès de base
Vérifier si vous êtes connecté à un compte administrateur Google Ads
Vous devez vous connecter à votre compte administrateur Google Ads pour accéder à votre jeton de développeur. Il ne peut pas s'agir d'un compte administrateur de test Google Ads.
Pour vérifier si vous êtes connecté au compte administrateur Google Ads, procédez comme suit :
Accédez à https://ads.google.com/aw/apicenter dans votre navigateur Web.
Si vous êtes connecté à un compte client, la page affiche le message Le centre API n'est disponible que pour les comptes administrateur.
Où trouver votre jeton de développeur
Vous pouvez trouver le jeton de développeur, s'il existe, sur la page Centre API de votre compte administrateur Google Ads.