Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Erreurs courantes

Ce guide répertorie les erreurs courantes de l'API et propose des stratégies pour les éviter et les gérer.

Pour obtenir la liste complète de tous les types d'erreurs, consultez la documentation de référence sur les erreurs de l'API Google Ads. Si vous avez besoin d'aide supplémentaire, posez une question sur le forum API Google Ads.

`google.rpc.ErrorInfo`

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Résumé	Le jeton d'accès OAuth 2.0 ne dispose pas des autorisations requises.
Causes courantes	La requête est refusée, car le jeton d'accès fourni n'inclut pas l'autorisation OAuth 2.0 de l'API Google Ads.
Réponse	Assurez-vous que le jeton d'accès dispose des autorisations requises. Cette erreur est souvent due au fait que vous réutilisez un jeton d'accès existant généré avec un ensemble différent d'autorisations OAuth. Consultez les paramètres d'autorisation OAuth pour obtenir un exemple de génération d'un jeton d'accès avec les autorisations requises.
Conseils de prévention	Assurez-vous que le jeton d'accès dispose des autorisations requises. Réauthentifiez votre utilisateur avec les autorisations requises pour obtenir un accès avec les autorisations requises. Si votre application utilise plusieurs autorisations OAuth, vous devrez peut-être implémenter des autorisations OAuth précises.

invalid_grant

Résumé	Le jeton a expiré ou a été révoqué.
Causes courantes	Un projet Google Cloud Platform avec un écran de consentement OAuth configuré pour un type d'utilisateur externe et un état de publication `Testing` reçoit un jeton d'actualisation qui expire dans sept jours.
Réponse	L'état de publication de votre projet Google est `Testing`. Par conséquent, le jeton d'actualisation expire tous les sept jours et reçoit une erreur `invalid_grant`. Accédez à la console Google APIs, puis à l'écran de consentement OAuth. Modifiez ensuite l'état de publication sur `In production` pour éviter que le jeton d'actualisation n'expire dans sept jours.
Conseils de prévention	Consultez Applications non validées.

CLIENT_CUSTOMER_ID_INVALID

Résumé	L'ID client n'est pas un nombre.
Causes courantes	Utilisation d'un numéro client incorrect.
Réponse	N/A
Conseils de prévention	123-456-7890 doit être 1234567890. Pour en savoir plus, consultez Commencer.

CLIENT_CUSTOMER_ID_IS_REQUIRED

Résumé	L'ID client n'a pas été spécifié dans l'en-tête HTTP.
Causes courantes	Non-spécification d'un ID client dans l'en-tête HTTP.
Réponse	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 cela pour vous.

CUSTOMER_NOT_FOUND

Résumé	Aucun compte n'a été trouvé pour le numéro client fourni dans l'en-tête.
Causes courantes	Tentative d'accès à un compte qui vient d'être créé avant qu'il ne soit établi dans le backend.
Réponse	Attendez cinq minutes, puis réessayez toutes les 30 secondes.
Conseils de prévention	Attendez 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 requête n'est pas valide ou a expiré.
Causes courantes	Le jeton d'accès a été invalidé.
Réponse	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é.
Réponse	Assurez-vous de 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 en question, 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.
Réponse	N/A
Conseils de prévention	Assurez-vous d'avoir transmis le jeton d'accès correct 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. Consultez le guide d'authentification des utilisateurs.

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION

Résumé	Le projet Google Cloud ne dispose que d'un accès test et ne peut pas être utilisé pour accéder aux comptes de production.
Causes courantes	Un projet Google Cloud avec le niveau d'accès test a été utilisé pour envoyer une requête à un compte Google Ads non test (de production). (Dans les versions 24 et antérieures de l'API, cette condition renvoie `AuthorizationError.ACTION_NOT_PERMITTED`.)
Réponse	Si vous effectuez des tests, assurez-vous que votre requête cible un compte test. Si vous souhaitez accéder à un compte Google Ads de production, vérifiez le niveau d'accès de votre projet Google Cloud sur la page Présentation de l'API Google Ads et passez au niveau d'accès de votre projet Explorateur, Basique ou Standard.
Conseils de prévention	N/A

CUSTOMER_NOT_ENABLED

Résumé	Il est impossible d'accéder au compte client, car il n'est pas activé.
Causes courantes	Ce problème se produit lorsque le compte client n'a pas terminé son inscription ou a été désactivé.
Réponse	Connectez-vous à l'interface utilisateur Google Ads et assurez-vous d'avoir terminé le processus d'inscription pour ce compte. Pour les comptes désactivés, consultez Réactiver un compte Google Ads désactivé.
Conseils de prévention	Vous pouvez vérifier de manière proactive si un compte client est désactivé en recherchant l'état ANNULÉ.

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.
Réponse	N/A
Conseils de prévention	Spécifiez le `login-customer-id` comme ID de compte administrateur sans tirets (`-`). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.