Le jeton de développeur est une chaîne alphanumérique de 22 caractères qui permettait de 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 sur cette migration pour aider les développeurs existants.
Ce qui change
Nous avons apporté plusieurs modifications à l'expérience d'intégration de l'API Google Ads et à la gestion des accès à l'API dans le cadre de l'abandon du jeton de développeur. Cette section met en évidence les principales modifications.
Les niveaux d'accès aux API sont associés à des projets Google Cloud.
Nous avons supprimé les jetons de développeur le 9 septembre 2026. Le niveau d'accès de votre jeton de développeur actif a été automatiquement transféré à vos projets Google Cloud en fonction de l'activité de l'API au cours des 90 jours précédant l'abandon. 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é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 propriétaire de votre compte de service.
Une nouvelle expérience d'inscription pour l'API Google Ads
Vous pouvez vous inscrire pour accéder à l'API Google Ads directement dans la console Google Cloud, sans avoir besoin d'un compte administrateur Google Ads. N'essayez pas d'obtenir un jeton de développeur depuis la page Centre d'API ni de demander l'accès à l'API depuis la page Centre d'API de votre compte administrateur Google Ads. Ces processus ont été transférés vers la console Google Cloud et ne seront pas traités s'ils sont lancés depuis la page "Centre d'API".
Une nouvelle expérience de gestion des accès aux API
Nous avons supprimé toutes les fonctionnalités de gestion des nouvelles inscriptions et des accès à l'API, comme la demande d'accès à l'API et la gestion des niveaux d'accès à l'API sur la page du Centre d'API dans les comptes administrateur Google Ads. Ces fonctionnalités sont disponibles sur la page Présentation de l'API Google Ads de la console Google Cloud.
Vous pouvez toujours accéder à la page 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
Dans la version 25 et ultérieure, l'API Google Ads génère une erreur AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION si vous essayez d'utiliser un projet Google Cloud avec un accès test pour appeler un compte de production. Les anciennes versions de l'API (v24 et antérieures) génèrent plutôt une erreur AuthorizationError.ACTION_NOT_PERMITTED. Si vous rencontrez cette erreur, accédez à la page de présentation de l'API Google Ads de votre projet Google Cloud et demandez l'accès à Explorer.
La validation de la marque est requise pour l'accès de base et l'accès standard
Pour les nouvelles demandes 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 de valider leur marque, mais nous les y encourageons.
Les demandes d'accès de base sont automatisées et seront examinées dans les minutes qui suivent la validation et l'envoi de la marque.
En raison de ces changements, toutes les demandes d'accès de base en attente sont clôturées dans le cadre de cette transition. Les développeurs concernés recevront un e-mail contenant des informations détaillées et devront de nouveau demander un accès de base sur la page Présentation de l'API Google Ads.
Nouvelles adresses e-mail de contact pour l'API
En prévision de la mise hors service de la page "Centre API", nous allons utiliser la liste des utilisateurs propriétaires et éditeurs de votre projet Google Cloud comme seul canal pour les communications administratives et de conformité obligatoires. Pour faciliter la transition, nous continuerons temporairement à envoyer des annonces obligatoires sur le service à l'adresse e-mail indiquée dans votre centre d'API. Nous vous tiendrons informé lorsque nous finaliserons la transition de nos canaux de communication.
Que faire si vous êtes déjà développeur ?
Vérifiez les niveaux d'accès à l'API de votre projet Google Cloud : si vous êtes déjà développeur, nous vous invitons à consulter la page Vue d'ensemble 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 éventuels écarts.
Vérifiez l'adresse e-mail de contact de l'API : accédez à la page IAM (Identity and Access Management) de votre projet Google Cloud. Vérifiez que les développeurs Ads et les responsables de compte actifs se voient attribuer les 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 d'envoyer les MSA à l'adresse e-mail de contact indiquée dans votre Centre API pendant une période temporaire. Nous vous informerons chaque fois que cette procédure sera mise à jour.
Corrigez le code de votre application : nous vous encourageons à mettre à jour votre application pour qu'elle cesse d'envoyer un jeton de développeur dans vos 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 à rejeter les jetons de développeur dans les appels d'API dans une prochaine version majeure de l'API Google Ads. Si votre application utilise ces bibliothèques, mettez à jour ses dépendances pour utiliser la dernière version.
Si vous avez besoin d'aide ou si vous avez d'autres questions, contactez l'assistance de l'API Google Ads.
Problèmes connus
Cette section décrit tous les problèmes connus liés à l'abandon des jetons de développeur.
Les utilisateurs ne bénéficient pas de l'accès Explorer ni de l'accès de base, même après avoir effectué la validation de la marque
Nous avons été informés d'un problème qui empêche certains utilisateurs disposant de projets validés par la marque d'obtenir l'accès de base. Les utilisateurs recevront un e-mail de refus indiquant "L'accès de base nécessite un profil de marque OAuth validé. Nous n'avons pas pu approuver votre demande, car vous n'avez pas validé la marque de votre projet." De même, certains utilisateurs qui s'inscrivent pour obtenir un accès Explorer sont également refusés. Ils reçoivent un e-mail de refus indiquant : "Pour le moment, nous ne pouvons pas accorder l'accès Explorer à votre projet Google Cloud, car il ne répond pas aux critères d'éligibilité requis pour l'accès direct à un compte de production conformément aux règles et conditions d'utilisation de l'API Google Ads."
Origine du problème
Votre projet Google Cloud peut faire partie du programme d'essai sans frais de Google Cloud ou disposer d'un compte de facturation suspendu ou désactivé.
Procédure de validation
Vérifiez l'état de votre facturation Google Cloud. Si votre projet de facturation est indiqué comme "Compte d'essai sans frais" ou est suspendu ou désactivé, vous êtes concerné par ce problème.
État
Nous avons identifié la cause du problème et nous nous efforçons de le résoudre.
Solution temporaire
Il existe plusieurs solutions pour résoudre ce problème. Sélectionnez l'option la plus adaptée à votre cas d'utilisation.
Passer à un niveau payant pour votre projet Google Cloud
Passez votre projet Google Cloud à un niveau payant. Patientez quelques minutes, puis réessayez de demander l'accès de base.
Supprimer la facturation pour votre projet Google Cloud
Si vous n'avez pas d'autres services en cours d'exécution dans votre projet Google Cloud, supprimez la facturation de votre projet Google Cloud. Patientez quelques minutes, puis réessayez de demander l'accès de base.
Utiliser un autre projet Google Cloud
Si vous disposez d'un autre projet Google Cloud dont la marque est validée, utilisez-le pour demander l'accès de base.
Les projets dont les niveaux d'accès de base ou Explorateur ont été approuvés récemment reçoivent une erreur AUTHORIZATION_ERROR.
Nous avons été informés d'un problème : certains utilisateurs ayant fait passer le niveau d'accès de leur projet Google Cloud au niveau d'accès de base ou d'explorateur approuvé après le 9 septembre 2026 reçoivent une erreur AUTHORIZATION_ERROR lorsqu'ils effectuent des appels d'API Google Ads vers des comptes de production.
Origine du problème
L'API Google Ads n'honore pas les mises à niveau du niveau d'accès à l'API effectuées depuis la console Google Cloud pour certains projets.
Procédure de validation
Vous êtes concerné par ce problème si toutes les conditions suivantes sont remplies :
- Vous disposez d'un jeton de développeur avec un niveau d'accès "Test".
- Vous avez utilisé votre projet Google Cloud et votre jeton de développeur pour effectuer des appels d'API Google Ads avant le 9 septembre 2026.
- Vous avez fait passer le niveau d'accès de votre projet Google Cloud à l'accès Explorer, Basic ou Standard après le 9 septembre 2026.
- Vos appels d'API vers un compte de production échouent et renvoient un
AUTHORIZATION_ERROR. Les appels d'API vers les comptes de test sont réussis.
État
Nous avons trouvé une solution à ce problème et nous nous efforçons de la déployer sur nos serveurs. Une fois le correctif déployé, vos appels d'API fonctionneront à nouveau.
Solution temporaire
Vous pouvez utiliser un nouveau projet Google Cloud pour demander l'accès Explorer.
Questions fréquentes
La section suivante fournit des réponses aux questions fréquentes sur l'abandon des jetons de développeur et les niveaux d'accès à l'API.
Qu'advient-il des niveaux d'accès à l'API ?
Les niveaux d'accès aux API sont toujours appliqués dans l'API Google Ads. Toutefois, ces autorisations sont accordées à votre projet dans la console Google Cloud, et non à votre jeton de développeur. Lorsque vous effectuez des appels d'API, vos niveaux d'accès aux API sont 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 par 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 propriétaire 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 vers vos projets Google Cloud comme suit :
- Nous avons examiné les journaux d'appels d'API des 90 derniers jours pour identifier les projets Cloud 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 ce changement ?
Oui, vous pouvez disposer de plusieurs projets Google Cloud avec différents niveaux d'accès aux API. Par exemple, vous pouvez avoir un projet Google Cloud avec un accès de base et un autre projet Google Cloud avec un accès standard.
Exemple
Par exemple, supposons que vous disposiez 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. Elle a été utilisée avec les ID de projet suivants :1234567890,5678912345,45678912345. - Jeton de développeur 2 :
xyzabcdefghi6789012345dispose d'un accès de base. Il a été utilisé avec les ID de projet suivants :1231235678. - Jeton de développeur 3 :
asdfgflkjhjz7654321012dispose d'un accès de base, mais n'a jamais été utilisé pour effectuer un appel d'API. Elle a été approuvée dans les 90 jours précédant le 9 septembre 2026. - Jeton de développeur 4 :
qwertypoiuyu6543298790disposait d'un accès standard, mais il n'a pas été utilisé au cours des 90 derniers jours. L'ID de projet9876564900a été utilisé avec ce jeton de développeur il y a plus de 90 jours. - Projet Cloud : l'ID de projet Cloud
7171234567n'a jamais été utilisé avec un jeton 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 aux 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, car il n'a jamais été utilisé pour effectuer un appel d'API. |
qwertypoiuyu6543298790 |
9876564900 |
Tester l'accès | L'accès à l'API du jeton de développeur a été révoqué en raison d'une inactivité de 90 jours. Le niveau d'accès à l'API du projet est défini par défaut sur "Accès test". |
-- |
7171234567 |
Tester l'accès | Il s'agit d'un nouveau projet qui n'a jamais été utilisé avec un jeton de développeur. Le niveau d'accès à l'API du projet est défini par défaut sur "Accès Test". |
Je dispose de plusieurs jetons de développeur approuvés. À quel projet allez-vous transférer les niveaux d'accès aux API ?
Les niveaux d'accès de chaque jeton de développeur approuvé sont transférés vers les projets Google Cloud associés à ce jeton de développeur. Consultez un exemple.
J'utilise plusieurs projets Google Cloud. Pour 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'API que votre jeton de développeur. Voir un exemple
Des niveaux d'accès aux 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 parce que l'accès à l'API de votre jeton de développeur a expiré en raison d'une inactivité. Pour résoudre le problème, demandez le niveau d'accès à l'API approprié pour ce projet sur la page Vue d'ensemble de l'API Google Ads. Voir un exemple
Où puis-je voir 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 de présentation de l'API Google Ads.
Comment demander un niveau d'accès à l'API supérieur ?
Vous pouvez demander des niveaux d'accès à l'API plus élevés pour votre projet Google Cloud sur la page de présentation de l'API Google Ads.
Qu'advient-il de ma demande d'accès à l'API en attente ?
Toutes les demandes d'accès de base en attente que vous avez envoyées depuis le centre d'API de votre compte administrateur Google Ads avant le 9 septembre 2026 seront clôturées. Vous devez demander à nouveau l'accès de base sur la page Vue d'ensemble de l'API Google Ads de votre projet Google Cloud. Si vous êtes concerné par ce changement, vous recevrez un e-mail contenant les instructions nécessaires.
Toutes les demandes d'accès standard en attente que vous avez envoyées depuis le centre d'API de votre compte administrateur Google Ads au 9 septembre 2026 seront examinées comme d'habitude. Si votre demande est approuvée, le projet Google Cloud associé à votre jeton de développeur bénéficiera d'un accès standard.
Puis-je réassocier mon jeton de développeur approuvé à un nouveau projet Google Cloud ?
Avant le 9 septembre 2026, l'équipe de l'API Google Ads acceptait de réassocier 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ée depuis la page Vue d'ensemble de l'API Google Ads de 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 :
Votre accès au jeton de développeur peut être révoqué en cas d'inactivité : en vertu des 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, ses niveaux d'accès ont probablement été révoqués pour cause d'inactivité. Si tel est le cas, demandez à nouveau l'accès à l'API pour votre projet Google Cloud depuis la page de présentation de l'API Google Ads. Voir un exemple
Votre jeton de développeur a été approuvé dans les 90 jours précédant le 9 septembre 2026, mais vous ne l'avez jamais utilisé : 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 erreur
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONsi 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 approprié à l'API depuis la page Vue d'ensemble de l'API Google Ads de votre projet Google Cloud. Voir un exemple
Dans les deux cas, vous pouvez demander un accès Explorateur ou un accès de base. Votre demande sera examinée automatiquement. Vous n'avez plus besoin de contacter l'équipe Google chargée de la conformité pour finaliser 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. L'équipe chargée de la conformité pourra ainsi examiner votre nouvelle demande d'accès Standard en conséquence.
Puis-je arrêter d'envoyer des jetons de développeur dans mes requêtes API ?
Oui, vous pouvez cesser d'envoyer des jetons de développeur dans vos requêtes API. Si vous utilisez une bibliothèque cliente, vous devrez peut-être la mettre à niveau vers 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.
J'ai participé au programme pilote de niveau d'accès géré par Cloud. Dans quelle mesure cela me concerne-t-il ?
Le programme pilote sur les niveaux d'accès gérés dans le cloud a été lancé pour permettre aux développeurs Google Cloud d'effectuer des appels d'API sans envoyer de jeton de développeur dans la requête API. Maintenant que nous avons abandonné les jetons de développeur, ce programme sera arrêté.
Les niveaux d'accès de votre jeton de développeur actif ont été transférés vers 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 depuis la page Vue d'ensemble de l'API Google Ads de votre projet Google Cloud.
Mon jeton de développeur figurait sur une liste d'autorisation. Dans quelle mesure cela me concerne-t-il ?
Google peut lancer des programmes pilotes qui donnent accès à certains développeurs à des fonctionnalités expérimentales. L'accès à ces fonctionnalités est parfois accordé en ajoutant votre jeton de développeur à une liste d'autorisation. Si vous avez participé à 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 d'ajout à la 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 le 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ée depuis la page Vue d'ensemble 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. Étant donné que 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.
Qu'advient-il d'API Center ?
La page "Centre d'API" existante dans le compte administrateur Google Ads est obsolète et sera bientôt supprimée. Si vous possédez déjà 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 depuis la page Vue d'ensemble 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 de démarrage pour vous inscrire à l'API Google Ads. N'inscrivez-vous pas pour obtenir un jeton de développeur depuis le centre d'API de votre compte administrateur Google Ads. Ces demandes ne seront pas traitées. API Center sera bientôt abandonné.
Quelles autorisations IAM sont requises pour gérer les niveaux d'accès aux API ?
Vous devez disposer des autorisations de gestion des quotas pour votre projet Google Cloud afin de gérer les niveaux d'accès à l'API Google Ads. Les autorisations nécessaires sont incluses par défaut pour les rôles suivants : Propriétaire, Éditeur, Administrateur de quotas et Administrateur Service Usage. Pour en savoir plus, consultez la documentation sur les autorisations de quota.
Vous pouvez consulter la page IAM de votre projet Google Cloud pour voir les rôles qui vous sont attribués. Contactez l'administrateur de votre projet Google Cloud pour accorder les rôles IAM nécessaires à votre projet Google Cloud.