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 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 de l'accès à l'API dans le cadre de l'arrêt du jeton de développeur. Cette section met en évidence les principales modifications.
Les niveaux d'accès aux API sont associés aux projets Google Cloud.
Nous arrêterons 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é vers 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 aux 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 auquel appartient votre compte de service.
Nouvelle procédure d'inscription à l'API Google Ads
Vous pouvez désormais demander l'accès à l'API Google Ads directement dans la console Google Cloud, sans avoir besoin d'un compte administrateur Google Ads. N'inscrivez pas de jeton de développeur sur la page Centre d'API et n'essayez pas de demander l'accès à l'API sur 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".
Nouvelle expérience de gestion de l'accès aux API
Nous avons supprimé toutes les nouvelles fonctionnalités d'inscription et de gestion de l'accès aux API, comme la demande d'accès aux API et la gestion des niveaux d'accès aux API sur la page Centre d'API des 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 d'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 v25 de l'API Google Ads générera une erreur CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION si vous essayez d'utiliser un projet Google Cloud avec un accès test pour effectuer des appels vers un compte de production. Les anciennes versions de l'API génèrent plutôt une erreur ACTION_NOT_PERMITTED. Si vous rencontrez cette erreur, accédez à la page de 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 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 désormais automatisées et seront examinées quelques minutes après la validation de la marque et l'envoi de la demande.
En raison de ces modifications de processus, toutes les demandes d'accès de base en attente seront clôturées lors de cette transition. Les développeurs concernés recevront un e-mail contenant des informations détaillées et devront de nouveau demander l'accès Basic sur la page de présentation de l'API Google Ads.
Nouvelles adresses e-mail de contact pour les API
Alors que nous nous préparons à arrêter la page du centre d'API, nous allons utiliser la liste des propriétaires et des éditeurs de votre projet Google Cloud comme seul canal pour les communications administratives et obligatoires liées à la conformité. 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é de la finalisation de la transition de nos canaux de communication.
Que faire si vous êtes déjà développeur ?
Vérifiez les niveaux d'accès aux API de votre projet Google Cloud : si vous êtes déjà développeur, nous vous invitons à 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 aux API que votre jeton de développeur existant. Suivez les instructions de ce guide pour résoudre les éventuelles incohérences.
Vérifiez l'adresse e-mail de contact de votre API : accédez à la page IAM (Identity and Access Management) de votre projet Google Cloud. Vérifiez que vos développeurs et responsables de compte Ads actifs 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 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 le jeton de développeur dans les 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 pour l'API Google Ads si vous avez besoin d'aide ou si vous avez d'autres questions.
Problèmes connus
Cette section décrit tous les problèmes connus liés à l'arrêt des jetons de développeur.
Les utilisateurs n'ont pas accès à l'explorateur ni à l'accès de base, même après avoir validé leur marque
Nous avons été informés d'un problème qui empêche certains utilisateurs dont les projets sont validés en tant que marques d'obtenir un accès de base. Les utilisateurs recevront un e-mail de refus indiquant que "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 pour votre projet." De même, certains utilisateurs qui demandent un accès Explorateur sont également refusés et reçoivent un e-mail de refus indiquant "Nous ne pouvons pas accorder l'accès Explorateur à votre projet Google Cloud pour le moment, car il ne répond pas aux critères d'éligibilité requis pour l'accès direct à un compte de production en vertu de nos règles et conditions d'utilisation de l'API Google Ads."
Origine du problème
Il est possible que votre projet Google Cloud soit associé au programme d'essai sans frais Google Cloud ou à 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'exécutez pas d'autres services dans votre projet Google Cloud, supprimez la facturation pour 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 validé pour votre marque, utilisez-le pour demander l'accès Basic.
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 qui affecte certains utilisateurs ayant récemment modifié le niveau d'accès de leur projet Google Cloud pour passer à un niveau d'accès de base ou Explorer approuvé. Ils reçoivent un message d'erreur AUTHORIZATION_ERROR lorsqu'ils effectuent des appels à l'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 modifié le niveau d'accès de votre projet Google Cloud pour le passer à "Explorateur", "Basique" ou "Standard" après le 9 septembre 2026.
- Vos appels d'API à un compte de production échouent et renvoient un
AUTHORIZATION_ERROR. Les appels d'API aux comptes de test sont effectués avec succès.
État
Nous avons trouvé une solution à ce problème et nous nous efforçons de la déployer sur nos serveurs. Une fois la correction appliquée, vos appels d'API recommenceront à fonctionner.
Solution temporaire
Vous pouvez utiliser un nouveau projet Google Cloud pour demander l'accès Explorer.
Questions fréquentes
Que deviennent les niveaux d'accès à l'API ?
Les niveaux d'accès aux 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 aux 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 auquel appartient votre compte de service.
Comment les projets ont-ils été identifiés pour le transfert des niveaux d'accès aux 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 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.
Pourrai-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. 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 les ID de projet suivants :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. - 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 déjà été utilisé avec ce jeton de développeur. - Le projet Cloud
7171234567n'a jamais été utilisé avec l'un des jetons de développeur pour effectuer un appel d'API.
Les niveaux d'accès aux 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, 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 é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 Test". |
J'ai plusieurs jetons de développeur approuvés. À quel projet transférerez-vous les niveaux d'accès à l'API ?
Les niveaux d'accès de chaque jeton de développeur approuvé seront transférés vers les projets Google Cloud associés à ce jeton de développeur. Consultez un exemple.
J'utilise plusieurs projets Google Cloud. À quel projet transférerez-vous 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é.
Aucun niveau d'accès aux API n'a été attribué à 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é récemment en raison de l'inactivité. Pour résoudre ce problème, demandez le niveau d'accès à l'API approprié pour ce projet sur la page Présentation de l'API Google Ads. Voir un exemple
Où puis-je consulter les niveaux d'accès aux 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 aux 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.
Qu'advient-il de ma demande d'accès aux 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 de nouveau demander l'accès de base depuis la page Présentation de l'API Google Ads de votre projet Google Cloud. Si ce changement vous concerne, 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, 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é ne sera plus disponible à partir du 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 de présentation de l'API Google Ads de votre projet Google Cloud.
J'ai 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é pour cause d'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 l'inactivité. Si tel est le cas, demandez à nouveau l'accès à l'API pour votre projet Google Cloud sur 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 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 à l'API appropriée sur la page Présentation de l'API Google Ads de votre projet Google Cloud. Consultez un exemple.
Dans les deux cas, vous pouvez demander à bénéficier des niveaux d'accès "Explorateur" et "De base", et vos demandes seront examinées 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 arrêter d'envoyer des jetons de développeur dans 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.
J'ai participé au programme pilote sur les niveaux d'accès gérés dans le 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 d'API. Maintenant que nous avons supprimé 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 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 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 qu'ils utilisent des projets Google Cloud au lieu de jetons de développeur comme mécanisme de liste d'autorisation. Nous avons également transféré l'état de la liste d'autorisation des jetons de développeur vers les projets Google Cloud associés. Votre code existant devrait continuer à fonctionner sans aucune modification. Si vous rencontrez toujours des problèmes, contactez votre responsable de compte Google qui vous a inscrit au programme pilote.
J'ai 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 sur 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. Étant donné que nous avons transféré les niveaux d'accès aux 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 du centre d'API ?
La page "Centre d'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 depuis cette page.
Si vous devez demander des niveaux d'accès à l'API plus élevés, vous devez le faire depuis la 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 de démarrage pour vous inscrire à l'API Google Ads. Ne demandez pas de jeton de développeur depuis le centre d'API de votre compte administrateur Google Ads, car ces demandes ne seront pas traitées. Le centre d'API 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 ont été attribués. Contactez l'administrateur de votre projet Google Cloud pour attribuer les rôles IAM nécessaires à votre projet Google Cloud.