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. Pour en obtenir un, inscrivez-vous sur la page Centre d'API de votre compte administrateur Google Ads. Chaque fois que vous effectuez un appel d'API, vous envoyez le jeton de développeur dans 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 vers lequel vous pouvez effectuer des appels. Lorsque vous vous inscrivez pour obtenir un jeton de développeur, le niveau d'accès Test est appliqué par défaut. Cela vous permet d'effectuer des appels d'API uniquement sur des comptes de test. Pour effectuer des appels d'API sur votre compte de production, vous devez demander un niveau d'accès de base ou standard pour votre jeton de développeur. Une fois votre demande de jeton de développeur examinée et approuvée, le jeton de développeur se verra accorder le niveau d'accès approprié.
Avez-vous besoin d'un nouveau jeton de développeur ?
La nécessité de demander 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 | Demandez un nouveau jeton de développeur. En savoir plus |
| Votre entreprise utilise activement l'API Google Ads ou l'a utilisée par le passé. | 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 elle développe également un nouveau produit ou outil. | Si vous êtes certain de ne pas pouvoir utiliser votre jeton de développeur existant, 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 situation, 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 | Indiquez ensuite les informations suivantes sur le développeur : | Remarques supplémentaires |
|---|---|---|
| Un développeur représentant votre entreprise ou une équipe produit | Nom et URL de votre entreprise | Google n'accorde généralement qu'un seul jeton de développeur par entreprise, mais peut approuver des jetons de développeur distincts pour des outils distincts au cas par cas. |
| Un développeur individuel qui ne représente pas une entreprise | Indiquez le nom de votre entreprise sous la forme Individual. Vous pouvez fournir d'autres URL, comme celles de votre profil GitHub ou LinkedIn, au lieu de l'URL d'une 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 se déroule en deux étapes.
Étape 1 : Sélectionnez ou créez un compte administrateur Google Ads
Si vous possédez déjà un compte administrateur Google Ads, sélectionnez-le lorsque vous demandez le jeton. 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 des jetons et simplifier la gestion des comptes par la suite.
Si vous n'en avez pas, vous pouvez suivre les instructions du centre d'aide pour en créer un.
Étape 2 : Demandez 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. Connectez-vous à votre compte administrateur Google Ads si vous y êtes invité.
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, il est possible que Google ne puisse pas traiter votre demande et la refuse.
Assurez-vous que l'adresse e-mail de contact pour l'API que vous fournissez mène à une boîte de réception surveillée régulièrement. L'équipe Google chargée de la conformité des API pourra contacter cette adresse e-mail pour obtenir des précisions lors de l'examen. Si nous ne parvenons pas à vous joindre, Google pourra ne pas donner suite à votre demande.
Vous pouvez modifier votre adresse e-mail de contact pour l'API dans le Centre d'API. Veillez à ce que ces informations soient à jour, même après la procédure de demande, afin que Google puisse vous envoyer des annonces importantes sur le service.
Une fois la procédure de demande terminée, le jeton de développeur apparaît dans votre centre API avec l'état En attente d'approbation. Votre jeton de développeur dispose désormais du niveau d'accès Compte de test. Vous pouvez commencer à effectuer des appels d'API sur des comptes de test.
Vérifier si vous êtes connecté à un compte administrateur
Vous devez vous connecter à votre compte administrateur pour accéder à votre jeton de développeur. Il ne peut pas s'agir d'un compte administrateur de test.
Pour vérifier si vous êtes connecté au compte administrateur :
Accédez à https://ads.google.com/aw/apicenter dans votre navigateur Web.
Si vous êtes connecté à un compte client, la page affichera le message Le centre API n'est disponible que pour les comptes administrateur..
Si Compte de test s'affiche en rouge en haut à droite, cela signifie que votre compte est un compte de test de responsable ou d'annonceur.
Où trouver votre jeton de développeur ?
Si vous en avez un, vous trouverez votre jeton de développeur sur la page Centre API de votre compte administrateur Google Ads.