Erreurs courantes

Cette page liste les erreurs courantes et fournit des conseils pour les éviter et les traiter. Pour obtenir la liste complète des erreurs, consultez la documentation de référence sur les 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 qui expire 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 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 en suivant ces instructions 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éLe numéro client n'est pas un nombre.
Causes courantes Utilisation d'un numéro 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éL'ID client n'a pas été spécifié dans l'en-tête HTTP.
Causes courantes Vous n'avez pas indiqué d'ID client client dans l'en-tête HTTP.
Gestion N/A
Conseils de prévention L'ID 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, qui s'en chargent pour vous.
CUSTOMER_NOT_FOUND
RésuméAucun compte n'a été trouvé pour le numéro client indiqué dans l'en-tête.
Causes courantes Tentative d'accès à un compte qui vient d'être créé avant que le compte ne soit établi dans le backend.
Gestion Patientez cinq minutes, puis réessayez toutes les 30 secondes.
Conseils de prévention Une fois le compte créé, attendez quelques minutes avant d'envoyer des demandes à son égard.
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 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 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 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 d'un compte administrateur, assurez-vous d'obtenir le jeton d'actualisation pour le compte administrateur. Pour en savoir plus, consultez notre guide sur les jetons d'accès et d'actualisation et 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 l'inscription du compte client n'est pas terminée ou qu'il a été désactivé.
Gestion Connectez-vous à l'interface utilisateur Google Ads et vérifiez que vous avez terminé la procédure d'inscription pour ce compte. Pour réactiver un compte Google Ads, 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 affichant l'état CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
RésuméLe jeton de développeur ne peut être utilisé qu'avec des comptes de test et lorsque vous tentez d'accéder à un compte autre qu'un compte de test.
Causes courantes Un jeton de développeur test a été utilisé pour accéder à un compte autre qu'un compte de test.
Gestion Assurez-vous de bien vouloir accéder à un compte non-test. Si tel est le cas, vous devez demander à ce que votre jeton de développeur passe à 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 que d'un seul compte administrateur. Lorsque vous envoyez une requête à l'API Google Ads, le jeton de développeur est définitivement associé 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 s'affiche lorsque vous effectuez une requête.
Gestion N/A
Conseils de prévention Si vous passez à un jeton de développeur dans un nouveau compte administrateur, vous devrez créer un projet de 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 tirets (-). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.