Erreurs courantes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page répertorie les erreurs courantes et fournit des conseils pour les éviter et les gérer.
Pour obtenir la liste complète des erreurs, consultez les informations de référence sur les erreurs. Pour obtenir de l'aide, consultez notre forum.
google.rpc.ErrorInfo
|
ACCESS_TOKEN_SCOPE_INSUFFICIENT |
| Résumé | Le jeton d'accès OAuth 2.0 ne dispose pas des champs d'application requis. |
|---|
| Causes courantes |
La requête est refusée, car le jeton d'accès fourni n'inclut pas le champ d'application OAuth 2.0 de l'API Google Ads.
|
|---|
| Comment gérer |
Assurez-vous que le jeton d'accès dispose des autorisations requises. Cette erreur se produit souvent lorsque vous réutilisez un jeton d'accès existant qui a été généré à l'aide d'un ensemble différent de champs d'application OAuth. Consultez les paramètres d'autorisation OAuth pour obtenir un exemple de génération d'un jeton d'accès avec les champs d'application requis.
|
|---|
| Conseils de prévention |
Assurez-vous que le jeton d'accès dispose des niveaux d'accès requis. Réauthentifiez votre utilisateur avec les niveaux d'accès requis pour obtenir un accès avec les niveaux d'accès requis. Si votre application utilise plusieurs niveaux d'accès OAuth, vous devrez peut-être implémenter des autorisations OAuth précises.
|
|---|
|
google.auth.exceptions.RefreshError
|
invalid_grant |
| Résumé | Le jeton a expiré ou a été révoqué. |
|---|
| Causes courantes |
Un jeton d'actualisation expirant dans sept jours est émis pour un projet Google Cloud Platform avec un écran de consentement OAuth configuré pour un type d'utilisateur externe et un état de publication Testing.
|
|---|
| Comment gérer |
L'état de publication de votre projet Google est Testing. Le jeton d'actualisation expire donc tous les sept jours et génère une erreur invalid_grant. Accédez à la console Google APIs, puis à l'écran d'autorisation OAuth. Ensuite, définissez l'état de publication sur In production en suivant ces instructions pour éviter que le jeton d'actualisation n'expire au bout de sept jours.
|
|---|
| Conseils de prévention |
Consultez Applications non validées.
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| Résumé | Le numéro client n'est pas un nombre. |
|---|
| Causes courantes |
Vous utilisez un numéro client incorrect.
|
|---|
| Comment gérer |
N/A
|
|---|
| Conseils de prévention |
123-456-7890 doit être remplacé par 1234567890. Pour en savoir plus, consultez Premiers pas.
|
|---|
|
CLIENT_CUSTOMER_ID_IS_REQUIRED |
| Résumé | L'ID client n'a pas été spécifié dans l'en-tête HTTP. |
|---|
| Causes courantes |
Ne pas spécifier de numéro client dans l'en-tête HTTP.
|
|---|
| Comment gérer |
N/A
|
|---|
| Conseils de prévention |
L'ID client est obligatoire pour tous les appels. Assurez-vous donc d'en avoir spécifié un dans l'en-tête HTTP. Envisagez d'utiliser nos bibliothèques clientes, car elles gèrent cette opération pour vous.
|
|---|
|
CUSTOMER_NOT_FOUND |
| Résumé | Aucun compte trouvé pour le numéro client fourni dans l'en-tête. |
|---|
| Causes courantes |
Vous essayez d'accéder à un compte qui vient d'être créé avant qu'il ne soit établi dans le backend.
|
|---|
| Comment gérer |
Patientez cinq minutes, puis réessayez toutes les 30 secondes.
|
|---|
| Conseils de prévention |
Patientez quelques minutes après la création du compte avant d'envoyer des requêtes.
|
|---|
|
GOOGLE_ACCOUNT_COOKIE_INVALID |
| Résumé | Le jeton d'accès dans l'en-tête de la requête n'est pas valide ou a expiré. |
|---|
| Causes courantes |
Le jeton d'accès a été invalidé.
|
|---|
| Comment gérer |
Demandez un nouveau jeton. Si vous utilisez l'une de nos bibliothèques clientes, consultez sa documentation pour savoir comment actualiser le jeton.
|
|---|
| Conseils de prévention |
Stockez et réutilisez les jetons d'accès jusqu'à leur expiration.
|
|---|
|
NOT_ADS_USER |
| Résumé | Le compte Google utilisé pour générer le jeton d'accès n'est associé à aucun compte Google Ads. |
|---|
| Causes courantes |
Les informations de connexion fournies correspondent à un compte Google pour lequel Google Ads n'est pas activé.
|
|---|
| Comment gérer |
Veillez à vous connecter avec un compte Google Ads valide (généralement votre compte administrateur) pour le flux OAuth. Vous pouvez également inviter le compte Google à accéder à un compte Google Ads existant en vous connectant à votre compte administrateur, en sélectionnant le compte client ou administrateur concerné, en accédant à Tools and Settings > Access and security, puis en ajoutant l'adresse e-mail du compte Google.
|
|---|
| Conseils de prévention |
N/A
|
|---|
|
OAUTH_TOKEN_INVALID |
| Résumé | Le jeton d'accès OAuth dans l'en-tête n'est pas valide. |
|---|
| Causes courantes |
Le jeton d'accès transmis avec l'en-tête HTTP n'était pas correct.
|
|---|
| Comment gérer |
N/A
|
|---|
| Conseils de prévention |
Assurez-vous d'avoir transmis le bon jeton d'accès associé à votre compte. Il est parfois confondu avec les jetons d'actualisation et les codes d'autorisation. Si vous souhaitez obtenir des identifiants permettant d'accéder à tous les comptes client d'un compte administrateur, assurez-vous d'obtenir le jeton d'actualisation pour le compte administrateur. Pour en savoir plus, consultez notre guide sur les jetons d'accès et d'actualisation et OAuth2.
|
|---|
|
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN |
| Résumé | Le jeton de développeur est déjà associé à une organisation Google Cloud et ne peut pas être associé à une autre organisation. |
|---|
| Causes courantes |
Le jeton de développeur n'est pas associé à un projet Google Cloud dans la même organisation Google Cloud que le projet Google Cloud utilisé pour envoyer les requêtes à l'origine.
|
|---|
| Comment gérer |
Si vous avez déjà envoyé des requêtes API avec le jeton de développeur, assurez-vous que l'ID client OAuth est associé à des projets Google Cloud de la même organisation Google Cloud.
|
|---|
| Conseils de prévention |
Assurez-vous que tous vos projets Google Cloud sont associés à la même organisation Google Cloud. Un projet Google Cloud ne peut être associé qu'à un seul jeton de développeur, mais un jeton de développeur peut être associé à plusieurs projets de l'organisation.
|
|---|
|
DEVELOPER_TOKEN_INVALID |
| Résumé | Le jeton de développeur n'est pas valide. |
|---|
| Causes courantes |
Cette erreur est généralement due à des fautes de frappe dans le jeton de développeur ou à une configuration incorrecte du jeton de développeur dans un autre en-tête de requête.
|
|---|
| Comment gérer |
Veillez à copier le jeton de développeur depuis le centre d'API pour éviter les fautes de frappe. Vous trouverez le centre d'API dans votre compte administrateur Google Ads. Assurez-vous également de définir le jeton de développeur dans le bon en-tête. Les jetons de développeur sont parfois confondus avec les jetons d'actualisation et les codes d'autorisation OAuth. Pour en savoir plus sur les différents en-têtes de requête, cliquez ici.
|
|---|
| Conseils de prévention |
N/A
|
|---|
|
|
CUSTOMER_NOT_ENABLED |
| Résumé | Le compte client est inaccessible, car il n'est pas activé. |
|---|
| Causes courantes |
Cela se produit lorsque le client n'a pas terminé de s'inscrire ou que son compte a été désactivé.
|
|---|
| Comment gérer |
Connectez-vous à l'interface utilisateur Google Ads et assurez-vous d'avoir terminé la procédure d'inscription pour ce compte. Pour les comptes désactivés, consultez Réactiver un compte Google Ads.
|
|---|
| Conseils de prévention |
Vous pouvez vérifier de manière proactive si un compte client est désactivé en recherchant l'état ANNULÉ.
|
|---|
|
DEVELOPER_TOKEN_NOT_APPROVED |
| Résumé | Le jeton de développeur n'est approuvé que pour les comptes de test et a tenté d'accéder à un compte qui n'est pas un compte de test. |
|---|
| Causes courantes |
Un jeton de développeur de test a été utilisé pour accéder à un compte qui n'est pas un compte de test.
|
|---|
| Comment gérer |
Assurez-vous de vouloir accéder à un compte non test. Si c'est le cas, vous devez demander à ce que votre jeton de développeur soit mis à niveau pour bénéficier d'un accès standard ou de base.
|
|---|
| Conseils de prévention |
N/A
|
|---|
|
DEVELOPER_TOKEN_PROHIBITED |
| Résumé | Le jeton de développeur n'est pas autorisé avec le projet envoyé dans la demande. |
|---|
| Causes courantes |
Chaque projet de la console Google APIs ne peut être associé qu'au jeton de développeur d'un seul compte administrateur. Une fois que vous avez envoyé une requête à l'API Google Ads, le jeton de développeur est associé de manière permanente au projet Google API Console. Si vous n'utilisez pas un nouveau projet Google APIs Console, vous recevrez une erreur DEVELOPER_TOKEN_PROHIBITED lorsque vous enverrez une requête.
|
|---|
| Comment gérer |
N/A
|
|---|
| Conseils de prévention |
Si vous passez à un jeton de développeur sous un nouveau compte administrateur, vous devrez créer un projet de la console Google APIs pour les requêtes de l'API Google Ads qui utilisent le jeton du nouvel administrateur.
|
|---|
|
USER_PERMISSION_DENIED |
| Résumé | Le client autorisé n'a pas accès au client opérationnel. |
|---|
| Causes courantes |
Authentification en tant qu'utilisateur ayant accès à un compte administrateur, mais sans spécifier login-customer-id dans la requête.
|
|---|
| Comment gérer |
N/A
|
|---|
| Conseils de prévention |
Spécifiez login-customer-id comme ID de compte administrateur sans tirets (-). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.
|
|---|
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThis page provides solutions and preventative measures for common Google Ads API errors.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of errors, refer to the dedicated error references section.\u003c/p\u003e\n"],["\u003cp\u003eAdditional assistance and community support can be found on the Google Ads API forum.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding and addressing these errors is crucial for successful API integration and campaign management.\u003c/p\u003e\n"]]],[],null,[]]
