Erreurs courantes

Cette page répertorie les erreurs courantes et fournit des conseils pour les éviter et les traiter. Pour obtenir la liste complète des erreurs, consultez les références relatives aux erreurs. Pour obtenir de l'aide, consultez notre forum.

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 dont l'état de publication est Testing reçoit un jeton d'actualisation arrivant à expiration dans sept jours.
Gestion 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. Définissez ensuite l'état de publication sur In production en suivant ces instructions pour éviter que le jeton d'actualisation n'expire dans sept jours.
Conseils de prévention Pour en savoir plus, consultez Applications non validées.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
RésuméLe numéro client n'est pas un nombre.
Causes courantes Utilisation d'un numéro client client incorrect.
Gestion N/A
Conseils de prévention 123-456-7890 devrait ê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 Aucun numéro client client n'est spécifié dans l'en-tête HTTP.
Gestion N/A
Conseils de prévention Le numéro client étant requis pour tous les appels, assurez-vous d'en avoir spécifié un dans l'en-tête HTTP. Pensez à 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.
Gestion 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 à son encontre.
RésuméLe jeton d'accès indiqué dans l'en-tête de la requête n'est pas valide ou a expiré.
Causes courantes Le jeton d'accès n'est plus valide.
Gestion 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é.
Gestion 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 ce faire, connectez-vous à votre compte administrateur, sélectionnez le client ou le compte administrateur concerné, 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 figurant 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.
Gestion N/A
Conseils de prévention Assurez-vous d'avoir transmis le 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 rattachés à un compte administrateur, assurez-vous d'obtenir le jeton d'actualisation de ce compte. Pour en savoir plus, consultez notre guide sur les jetons d'accès et les jetons d'actualisation et sur OAuth2.

AuthorizationError

CUSTOMER_NOT_ENABLED
RésuméImpossible d'accéder au compte client, 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é.
Gestion 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.
Conseils de prévention Vous pouvez vérifier de manière proactive si le compte d'un client est désactivé en consultant l'état ANNULÉE.
DEVELOPER_TOKEN_NOT_APPROVED
RésuméLe jeton de développeur n'est approuvé que pour une utilisation avec des comptes de test et une tentative d'accès à un compte non test.
Causes courantes Un jeton de développeur test a été utilisé pour accéder à un compte qui n'est pas un compte test.
Gestion Vérifiez que vous souhaitez bien accéder à un compte qui n'est pas un compte test. Si tel est le cas, vous devez demander à faire passer votre jeton de développeur à 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 requête.
Causes courantes Chaque projet de la console Google APIs ne peut être associé au jeton de développeur qu'à partir d'un seul compte administrateur. Lorsque vous envoyez une demande à l'API Google Ads, le jeton de développeur est associé en permanence au projet de la console Google APIs. Si vous n'utilisez pas de nouveau projet dans la console Google APIs, une erreur DEVELOPER_TOKEN_PROHIBITED est renvoyée lorsque vous envoyez une requête.
Gestion N/A
Conseils de prévention Si vous passez à un jeton de développeur dans un nouveau compte administrateur, vous devez créer un projet dans la console Google APIs pour les requêtes API Google Ads qui utilisent le jeton du nouveau gestionnaire.
USER_PERMISSION_DENIED
RésuméLe client autorisé n'a pas accès au client opérationnel.
Causes courantes S'authentifier en tant qu'utilisateur ayant accès à un compte administrateur, mais sans spécifier login-customer-id dans la requête.
Gestion N/A
Conseils de prévention Indiquez login-customer-id comme ID de compte administrateur sans les traits d'union (-). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.