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.

google.auth.exceptions.RefreshError
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.

AuthenticationError
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.
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.

AuthorizationError
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é.

Précédent
Gérer les erreurs
Suivant
Étapes suivantes