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 liste les erreurs d'API courantes 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 de l'API Google Ads.

`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.
Réponse	Assurez-vous que le jeton d'accès dispose des champs d'application requis. Cette erreur est souvent due au fait que vous réutilisez un jeton d'accès existant qui a été généré à l'aide d'un autre ensemble de champs d'application OAuth. Consultez les paramètres d'autorisation OAuth pour obtenir un exemple de génération d'un nouveau jeton d'accès avec les champs d'application requis.
Conseils de prévention	Assurez-vous que le jeton d'accès dispose des champs d'application requis. Réauthentifiez votre utilisateur avec les champs d'application requis pour obtenir un accès avec les champs d'application requis. Si votre application utilise plusieurs champs d'application 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 au bout de sept jours.
Réponse	L'état de publication de votre projet Google est `Testing`. Le jeton d'actualisation expire donc tous les sept jours et reçoit une erreur `invalid_grant`. Accédez à la console Google APIs, puis à l'écran de consentement OAuth. Ensuite, définissez l'état de publication sur `In production` 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	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 Premiers pas.

CLIENT_CUSTOMER_ID_IS_REQUIRED

Résumé	Le numéro client n'a pas été spécifié dans l'en-tête HTTP.
Causes courantes	Ne pas spécifier d'ID client dans l'en-tête HTTP.
Réponse	N/A
Conseils de prévention	L'ID client est requis 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	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. Pour cela, connectez-vous à votre compte administrateur, sélectionnez le compte client ou administrateur en question, accédez à `Tools and Settings > Access and security`, puis ajoutez 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 que vous avez 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 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 un identifiant permettant d'accéder à tous les comptes client d'un compte administrateur, veillez à obtenir le jeton d'actualisation du 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 de 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 de production (autre que de test). (Dans les versions d'API v24 et antérieures, cette condition renvoie `AuthorizationError.ACTION_NOT_PERMITTED`.)
Réponse	Si vous effectuez des tests, assurez-vous que votre requête cible un compte de 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 Vue d'ensemble de l'API Google Ads et passez au niveau d'accès Explorer, Basic ou Standard.
Conseils de prévention	N/A

CUSTOMER_NOT_ENABLED

Résumé	Le compte client n'est pas accessible, car il n'est pas activé.
Causes courantes	Cela se produit lorsque le compte client n'a pas terminé l'inscription ou a été désactivé.
Réponse	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 CANCELLED.

USER_PERMISSION_DENIED

Résumé	Le client autorisé n'a pas accès au client d'exploitation.
Causes courantes	Vous vous authentifiez en tant qu'utilisateur ayant accès à un compte administrateur, mais vous ne spécifiez pas `login-customer-id` dans la requête.
Réponse	N/A
Conseils de prévention	Spécifiez l'ID du compte administrateur `login-customer-id` sans tirets (`-`). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.