Le jeton de développeur est une chaîne alphanumérique de 22 caractères qui était utilisée pour connecter votre application à l'API Google Ads. Les jetons de développeur ont été abandonnés le 9 septembre 2026. Ce guide récapitule les modifications et liste les questions fréquentes concernant cette migration pour aider les développeurs existants.
Ce qui change
Nous avons apporté plusieurs modifications à l'expérience d'intégration à l'API Google Ads et à la gestion de l'accès à l'API dans le cadre de l'abandon des jetons de développeur. Cette section met en évidence les principaux changements.
Les niveaux d'accès à l'API sont associés aux projets Google Cloud
Nous avons abandonné les jetons de développeur le 9 septembre 2026. Votre niveau d'accès actuel et actif au jeton de développeur a été automatiquement transféré à vos projets Google Cloud en fonction de l'activité récente de l'API. Vous pouvez continuer à envoyer des jetons de développeur dans les en-têtes de vos appels d'API, mais cela est facultatif et ignoré par les serveurs d'API. Votre code existant continuera de fonctionner sans aucune modification. Vos niveaux d'accès à l'API sont désormais déterminés par le projet Google Cloud que vous avez utilisé pour générer vos identifiants OAuth.
- Si votre application utilise le workflow d'authentification de l'utilisateur, il s'agit du projet qui possède votre ID client et votre code secret OAuth.
- Si vous utilisez le workflow de compte de service, il s'agit du projet qui possède votre compte de service.
Nouvelle expérience d'inscription à l'API Google Ads
Vous pouvez désormais vous inscrire pour accéder à l'API Google Ads directement dans la console Google Cloud sans avoir besoin d'un compte administrateur Google Ads. Ne vous inscrivez pas pour obtenir un jeton de développeur à partir de la page du centre API et n'essayez pas de demander l'accès à l'API à partir de la page du centre API dans votre compte administrateur Google Ads, car ces processus ont été transférés vers la console Google Cloud et ne seront pas traités s'ils sont lancés à partir de la page du centre API.
Nouvelle expérience de gestion de l'accès à l'API
Nous avons abandonné toutes les nouvelles fonctionnalités d'inscription et de gestion de l'accès à l'API, telles que la demande d'accès à l'API et la gestion des niveaux d'accès à l'API sur la page du centre API dans les comptes administrateur Google Ads. Ces fonctionnalités sont désormais disponibles sur la page Présentation de l'API Google Ads de la console Google Cloud.
Vous pouvez toujours accéder à la page du centre API pour consulter l' historique de vos informations de développeur. Cette page sera complètement abandonnée à l'avenir.
Nouveaux codes d'erreur
La version 25 de l'API Google Ads générera une CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION si vous essayez d' utiliser un projet Google Cloud avec un niveau d'accès "Compte test" pour effectuer des appels vers un compte de production. Les anciennes versions de l'API généreront plutôt une ACTION_NOT_PERMITTED. Si vous rencontrez cette erreur, accédez à la page Présentation de l'API Google Ads pour votre projet Google Cloud et demandez l'accès Explorer.
La validation de la marque est requise pour les accès de base et standard
Pour les nouvelles applications d'accès de base et standard, vous devez effectuer la validation de la marque pour votre projet Google Cloud. Les détenteurs d'accès existants ne sont pas tenus d'effectuer la validation de la marque, mais elle est recommandée.
Les applications d'accès de base sont désormais automatisées et seront examinées quelques minutes après la validation et l'envoi de la marque.
En raison de ces mises à jour du processus, toutes les demandes d'accès de base à l'API en attente seront clôturées dans le cadre de cette transition. Les demandeurs concernés recevront un e-mail contenant des informations détaillées et devront renouveler leur demande d'accès à l'API à partir de la page Présentation de l'API Google Ads.
Nouvelles adresses e-mail de contact pour l'API
Alors que nous nous préparons à désactiver la page du centre API, nous allons passer à l'utilisation de la liste des propriétaires et des éditeurs de votre projet Google Cloud comme seul canal pour les communications administratives et obligatoires concernant la conformité. Pour assurer une transition fluide, nous continuerons temporairement à envoyer des annonces obligatoires sur le service à l'adresse e-mail indiquée dans votre centre API. Nous vous tiendrons informé de la finalisation de la transition de nos canaux de communication.
Que faire si vous êtes un développeur existant ?
Vérifiez les niveaux d'accès à l'API de votre projet Google Cloud : si vous êtes un développeur existant, nous vous invitons vivement à consulter la page Présentation de l'API Google Ads de vos projets Google Cloud pour vous assurer qu'ils disposent du même niveau d'accès à l'API que votre jeton de développeur existant. Suivez les instructions de ce guide pour résoudre les éventuelles différences.
Vérifiez votre adresse e-mail de contact pour l'API : accédez à la page IAM (Identity and Access Management) de votre projet Google Cloud. Vérifiez que vos développeurs Ads actifs et vos responsables de compte disposent des rôles de propriétaire ou d'éditeur appropriés dans votre projet Google Cloud. Nous commencerons à envoyer des annonces obligatoires sur le service à ces adresses e-mail pour vous informer de toute modification future de l'API Google Ads. Nous continuerons à envoyer des annonces obligatoires sur le service à l'adresse e-mail de contact indiquée dans votre centre API pendant une période temporaire, et nous vous informerons chaque fois que ce processus sera mis à jour.
Corrigez le code de votre application : nous vous encourageons à mettre à jour votre application pour arrêter d'envoyer le jeton de développeur dans le cadre des appels d'API. Nous avons publié des versions mises à jour des bibliothèques clientes, du serveur MCP Google Ads et de l'assistant pour les développeurs de l'API Google Ads, qui vous permettent d'effectuer des appels d'API sans définir de jeton de développeur. Nous commencerons à refuser les jetons de développeur dans les appels d'API dans une future version majeure de l'API Google Ads. Si votre application utilise ces bibliothèques, mettez à jour les dépendances de l'application pour utiliser la dernière version.
Contactez l'assistance de l'API Google Ads si vous avez besoin d'aide supplémentaire ou si vous avez d'autres questions.
Questions fréquentes
Que deviennent les niveaux d'accès à l'API ?
Les niveaux d'accès à l'API sont toujours appliqués dans l'API Google Ads. Toutefois, ils sont désormais accordés à votre projet console Google Cloud au lieu de votre jeton de développeur. Lorsque vous effectuez des appels d'API, vos niveaux d'accès à l'API sont désormais déterminés par le projet Google Cloud que vous avez utilisé pour générer vos identifiants OAuth.
- Si votre application utilise le workflow d'authentification de l'utilisateur, il s'agit du projet qui possède votre ID client et votre code secret OAuth.
- Si vous utilisez le workflow de compte de service, il s'agit du projet qui possède votre compte de service.
Comment les projets ont-ils été identifiés pour le transfert des niveaux d'accès à l'API ?
Si vous disposiez déjà d'un jeton de développeur approuvé avant le 9 septembre 2026, ses niveaux d'accès ont été transférés à vos projets Google Cloud comme suit :
- Nous avons examiné les journaux d'appels d'API des 90 derniers jours pour identifier les projets Cloud qui ont été utilisés pour effectuer des appels d'API avec votre jeton de développeur approuvé.
- Nous avons attribué les niveaux d'accès à l'API du jeton de développeur à tous les projets Cloud identifiés.
Puis-je avoir plusieurs projets Cloud avec différents niveaux d'accès après cette modification ?
Oui, vous pouvez avoir plusieurs projets Google Cloud avec différents niveaux d'accès à l'API. Par exemple, vous pouvez avoir un projet Google Cloud avec un accès de base et un autre avec un accès standard.
Exemple
Supposons que vous disposez de quatre jetons de développeur et de six projets Cloud avec les informations suivantes :
- Le jeton de développeur 1 :
abcdefghijkl1234567890dispose d'un accès standard. Il a été utilisé avec les ID de projet suivants :1234567890,5678912345,45678912345. - Le jeton de développeur 2 :
xyzabcdefghi6789012345dispose d'un accès de base. Il a été utilisé avec l'ID de projet suivant :1231235678. - Le jeton de développeur 3 :
asdfgflkjhjz7654321012dispose d'un accès de base, mais n'a jamais été utilisé pour effectuer un appel d'API. Il a été approuvé récemment. - Le jeton de développeur 4 :
qwertypoiuyu6543298790disposait d'un accès standard, mais n'a pas été utilisé au cours des 90 derniers jours. L'ID de projet9876564900a été utilisé avec ce jeton de développeur par le passé. - Projet Cloud : l'ID de projet Cloud
7171234567n'a jamais été utilisé avec aucun des jetons de développeur pour effectuer un appel d'API.
Les niveaux d'accès à l'API seront transférés des jetons de développeur vers les projets Google Cloud comme suit :
| Jeton de développeur | ID du projet | Niveau d'accès | Explication |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
Accès standard | Le jeton de développeur et l'ID du projet sont associés. |
abcdefghijkl1234567890 |
5678912345 |
Accès standard | Le jeton de développeur et l'ID du projet sont associés. |
abcdefghijkl1234567890 |
45678912345 |
Accès standard | Le jeton de développeur et l'ID du projet sont associés. |
xyzabcdefghi6789012345 |
1231235678 |
Accès de base | Le jeton de développeur et l'ID du projet sont associés. |
asdfgflkjhjz7654321012 |
-- |
-- |
L'accès à l'API du jeton de développeur n'a été transféré à aucun projet puisqu'il n'a jamais été utilisé pour effectuer un appel d'API. |
qwertypoiuyu6543298790 |
9876564900 |
Accès au compte test | L'accès à l'API du jeton de développeur a été révoqué en raison de son inactivité pendant 90 jours. Le niveau d'accès à l'API du projet est défini par défaut sur "Accès au compte test". |
-- |
7171234567 |
Accès au compte test | Il s'agit d'un nouveau projet qui n'a été utilisé avec aucun jeton de développeur. Le niveau d'accès à l'API du projet est défini par défaut sur "Accès au compte test". |
Je dispose de plusieurs jetons de développeur approuvés. À quel projet allez-vous transférer les niveaux d'accès à l'API ?
Les niveaux d'accès de chaque jeton de développeur approuvé seront transférés aux projets Google Cloud associés à ce jeton de développeur. Voir un exemple.
J'utilise plusieurs projets Google Cloud. À quel projet allez-vous transférer les niveaux d'accès à l'API ?
Si vous avez utilisé plusieurs projets Google Cloud avec votre jeton de développeur approuvé au cours des 90 derniers jours, tous ces projets recevront les mêmes niveaux d'accès à l'APIque votre jeton de développeur. Voir un exemple.
Des niveaux d'accès à l'API ont été attribués à un projet que je n'utilise plus. Comment résoudre ce problème ?
Si l'accès à l'API Google Ads est attribué à un projet Google Cloud que vous n'utilisez plus, aucune action supplémentaire n'est requise de votre part. Google révoquera l'accès à l'API pour le projet inutilisé après 90 jours d'inactivité.
Les niveaux d'accès à l'API n'ont pas été attribués à mon projet Google Cloud. Comment résoudre ce problème ?
Votre projet Google Cloud n'a pas hérité du niveau d'accès de votre jeton de développeur, probablement parce que vous n'avez jamais utilisé votre jeton de développeur et le projet Cloud pour effectuer un appel d'API, ou que l'accès à l'API de votre jeton de développeur a expiré récemment en raison de son inactivité. Pour résoudre le problème, demandez le niveau d'accès à l'API approprié pour ce projet à partir de la page Présentation de l'API Google Ads. Voir un exemple.
Où puis-je consulter les niveaux d'accès à l'API de mon projet ?
Vous pouvez consulter le niveau d'accès à l'API de votre projet Google Cloud sur la page Présentation de l'API Google Ads.
Comment demander des niveaux d'accès à l'API plus élevés ?
Vous pouvez demander des niveaux d'accès à l'API plus élevés pour votre projet Google Cloud sur la page Présentation de l'API Google Ads.
Que devient ma demande d'accès à l'API en attente ?
Toutes les demandes d'accès de base en attente que vous avez lancées à partir du centre API de votre compte administrateur Google Ads avant le 9 septembre 2026 seront clôturées. Vous devez renouveler votre demande d'accès de base à partir de la page Présentation de l'API Google Ads de votre projet Google Cloud. Si vous êtes concerné par cette modification, vous recevrez un e-mail contenant les instructions nécessaires.
Toutes les demandes d'accès standard en attente que vous avez lancées à partir du centre API de votre compte administrateur Google Ads à compter du 9 septembre 2026 seront examinées comme d'habitude. Si votre demande est approuvée, l'accès standard sera accordé au projet Google Cloud associé à votre jeton de développeur.
Puis-je réassocier mon jeton de développeur approuvé à un nouveau projet Google Cloud ?
Auparavant, l'équipe de l'API Google Ads prenait en charge la réassociation d'un jeton de développeur à un nouveau projet Google Cloud au cas par cas. Cette fonctionnalité n'est plus disponible depuis le 9 septembre 2026, car nous avons abandonné les jetons de développeur. Si vous devez utiliser un nouveau projet Google Cloud, vous devez demander l'accès à l'API approprié à partir de la page Présentation de l'API Google Adsde votre projet Google Cloud.
Je dispose d'un jeton de développeur approuvé, mais je ne l'ai jamais utilisé. Puis-je utiliser ce jeton de développeur ?
Non, vous ne pouvez pas utiliser ce jeton de développeur. Deux possibilités s'offrent à vous :
L'accès à votre jeton de développeur peut être révoqué en raison de son inactivité : conformément aux règles de Google, Google peut révoquer votre jeton d'API s'il n'est pas utilisé pendant 90 jours consécutifs. Si vous n'avez pas utilisé votre jeton de développeur depuis un certain temps, il est probable que ses niveaux d'accès aient été révoqués en raison de son inactivité. Dans ce cas, demandez à nouveau l'accès à l'API pour votre projet Google Cloud à partir de la page Présentation de l'API Google Ads. Voir un exemple.
Votre jeton de développeur a été approuvé récemment, mais vous ne l'avez jamais utilisé avant le 9 septembre 2026 : comme vous n'avez jamais utilisé votre jeton de développeur approuvé avec un projet Google Cloud avant le 9 septembre 2026, ses niveaux d'accès n'ont pas été transférés vers le projet Cloud. Par conséquent, vous ne pouvez plus utiliser votre jeton de développeur. Nous générerons une
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONerreur si vous tentez d'effectuer un appel d'API vers un compte de production avec ce jeton de développeur. Pour corriger l'erreur, demandez l'accès à l'API approprié à partir de la page Présentation de l'API Google Ads de votre projet Google Cloud. Voir un exemple.
Dans les deux cas, vous pouvez demander l'accès Explorer et l'accès de base, et les faire examiner automatiquement. Vous n'avez plus besoin de collaborer avec l'équipe de conformité de Google pour effectuer le processus d'examen. Si vous avez besoin d'un accès standard, vous devez demander un examen manuel. Toutefois, vous pouvez partager les informations de votre jeton de développeur approuvé lorsque vous demandez un accès standard, afin que l'équipe de conformité puisse examiner votre nouvelle demande d'accès standard en conséquence.
Puis-je arrêter d'envoyer des jetons de développeur dans le cadre de mes requêtes API ?
Oui, vous pouvez arrêter d'envoyer des jetons de développeur dans le cadre de vos requêtes API. Si vous utilisez une bibliothèque cliente, vous devrez peut-être passer à la dernière version. Consultez les journaux des modifications de la bibliothèque pour vérifier si elle permet d'effectuer des appels d'API sans spécifier de jeton de développeur.
Je faisais partie du programme pilote sur le niveau d'accès géré par le cloud. Dans quelle mesure cela me concerne-t-il ?
Les niveaux d'accès de votre jeton de développeur actif ont été transférés à votre projet Google Cloud. Votre code existant devrait donc continuer à fonctionner sans aucune modification. Si vous devez utiliser un nouveau projet Google Cloud, vous devez demander l'accès à l'API à partir de la page Présentation de l'API Google Ads de votre projet Google Cloud.
Mon jeton de développeur faisait partie d'une liste d'autorisation. Dans quelle mesure cela me concerne-t-il ?
Google peut exécuter des programmes pilotes qui donnent à certains développeurs accès à des fonctionnalités expérimentales. L'accès à ces fonctionnalités est parfois fourni en ajoutant votre jeton de développeur à une liste d'autorisation. Si vous faisiez partie d'un tel programme pilote, aucune action n'est requise de votre part.
Nous avons mis à jour tous les programmes pilotes pour utiliser des projets Google Cloud au lieu de jetons de développeur comme mécanisme de liste d'autorisation, et nous avons transféré l'état de la liste d'autorisation du jeton de développeur vers les projets Google Cloud associés. Votre code existant devrait continuer à fonctionner sans aucune modification. Si le problème persiste, contactez votre responsable de compte Google qui vous a inscrit au programme pilote.
Je dispose d'un jeton de développeur approuvé et je souhaite l'utiliser avec un nouveau projet Google Cloud. Est-ce autorisé ?
Non, vous ne pouvez pas utiliser un nouveau projet Google Cloud avec votre jeton de développeur approuvé. Comme vous n'avez jamais utilisé votre jeton de développeur approuvé avec le nouveau projet Google Cloud avant le 9 septembre 2026, ses niveaux d'accès n'ont pas été transférés vers le projet Cloud. Nous générerons une erreur
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION si vous tentez
d'effectuer un appel d'API avec ce jeton de développeur, car les jetons de développeur ne sont plus
utilisés pour déterminer vos niveaux d'accès à l'API. Pour corriger l'erreur, demandez l'accès à l'API approprié à partir de la page Présentation de l'API Google Ads
de votre projet Google Cloud. Voir un exemple.
Mon jeton de développeur a été divulgué en externe. Dois-je réinitialiser mon jeton de développeur ?
Non, vous n'avez pas besoin de réinitialiser le jeton de développeur dans ce cas. Comme nous avons transféré les niveaux d'accès à l'API de votre jeton de développeur vers votre projet Google Cloud, un utilisateur non autorisé ne peut plus utiliser votre jeton de développeur avec son propre projet Google Cloud. Toutefois, vous pouvez réinitialiser le jeton de développeur à partir du centre API si vous le souhaitez.
Que devient le centre API ?
La page du centre API existante dans le compte administrateur Google Ads est obsolète et sera supprimée prochainement. Si vous disposez déjà d'un jeton de développeur, vous pouvez toujours vous connecter à votre compte administrateur Google Ads et afficher les détails. Toutefois, ces informations ne sont fournies qu'à titre de référence. N'effectuez aucune tâche liée aux niveaux d'accès des jetons de développeur, comme demander des niveaux d'accès à l'API plus élevés à partir de cette page.
Si vous devez demander des niveaux d'accès à l'API plus élevés, vous devez le faire à partir de votre page Présentation de l'API Google Ads de votre projet Google Cloud.
Ai-je toujours besoin d'un compte administrateur Google Ads pour utiliser l'API Google Ads ?
Vous n'avez plus besoin d'un compte administrateur Google Ads pour utiliser l'API Google Ads. Vous n'avez besoin d'un compte administrateur que si vous devez associer et gérer plusieurs comptes à l'aide de l'API.
Je suis un nouveau développeur. Comment m'inscrire à l'API Google Ads ?
Suivez les instructions du guide Premiers pas pour vous inscrire à l'API Google Ads. Ne vous inscrivez pas pour obtenir un jeton de développeur à partir du centre API de votre compte administrateur Google Ads. Ces demandes ne seront pas traitées. Le centre API sera abandonné prochainement.