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 niveaux d'accès requis. 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 niveaux d'accès 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 requis pour obtenir un accès avec les niveaux 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 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`.
Réponse	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 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 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 d'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 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.
Réponse	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 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 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.
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 de production (non test). (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 demande 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 mettez à niveau le niveau d'accès de votre projet vers un accès Explorateur, de base ou standard.
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 compte client n'a pas été créé 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 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 `login-customer-id` comme ID de compte administrateur sans tirets (`-`). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.