Erreurs courantes

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

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 courantesLa 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.
Comment gérerAssurez-vous que le jeton d'accès dispose des champs d'application requis. Cette erreur se produit généralement lorsque vous réutilisez un jeton d'accès existant généré à l'aide d'un autre ensemble de champs d'application OAuth. Pour savoir comment générer un nouveau jeton d'accès avec les champs d'application requis, consultez les paramètres d'autorisation OAuth.
Conseils de préventionAssurez-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.

google.auth.exceptions.RefreshError

invalid_grant
RésuméLe jeton a expiré ou a été révoqué.
Causes courantesUn projet Google Cloud Platform avec un écran de consentement OAuth configuré pour un type d'utilisateur externe et un état de publication de Testing reçoit un jeton d'actualisation qui expire dans sept jours.
Comment gérerL'é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 en suivant ces instructions pour éviter que le jeton d'actualisation n'expire dans sept jours.
Conseils de préventionConsultez Applications non validées.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
RésuméLe numéro client du client n'est pas un nombre.
Causes courantesUtilisation d'un numéro client client incorrect.
Comment gérerN/A
Conseils de prévention123-456-7890 doit être 1234567890. Pour en savoir plus, consultez Premiers pas.
CLIENT_CUSTOMER_ID_IS_REQUIRED
RésuméL'ID client du client n'a pas été spécifié dans l'en-tête HTTP.
Causes courantesVous n'avez pas spécifié d'ID client client dans l'en-tête HTTP.
Comment gérerN/A
Conseils de préventionL'ID client du 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 l'ID client fourni dans l'en-tête.
Causes courantesVous essayez d'accéder à un compte qui vient d'être créé avant qu'il ne soit établi dans le backend.
Comment gérerPatientez cinq minutes, puis réessayez toutes les 30 secondes.
Conseils de préventionAttendez quelques minutes après la création du compte avant d'envoyer des requêtes à son sujet.
RésuméLe jeton d'accès dans l'en-tête de la requête n'est pas valide ou a expiré.
Causes courantesLe jeton d'accès a été invalidé.
Comment gérerDemandez 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éventionStockez 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 courantesLes informations de connexion fournies correspondent à un compte Google dans lequel Google Ads n'est pas activé.
Comment gérerAssurez-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éventionN/A
OAUTH_TOKEN_INVALID
RésuméLe jeton d'accès OAuth dans l'en-tête n'est pas valide.
Causes courantesLe jeton d'accès transmis avec l'en-tête HTTP n'était pas valide.
Comment gérerN/A
Conseils de préventionAssurez-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 de rafraîchissement du compte administrateur. Pour en savoir plus, consultez nos guides sur les jetons d'accès et de rafraîchissement et sur OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
RésuméLe jeton de développeur est déjà associé à une organisation Google Cloud et ne peut pas être associé à une autre organisation.
Causes courantesLe jeton de développeur n'est pas associé à un projet Google Cloud appartenant à la même organisation Google Cloud que le projet Google Cloud utilisé pour effectuer les requêtes à l'origine.
Comment gérerAssurez-vous que l'ID client OAuth est associé aux projets Google Cloud de la même organisation Google Cloud si vous avez déjà effectué des requêtes API avec le jeton de développeur.
Conseils de préventionAssurez-vous que tous vos projets Google Cloud sont associés à la même organisation Google Cloud. Un projet Google Cloud ne peut être associé qu'à un seul jeton de développeur, mais un jeton de développeur peut être associé à plusieurs projets de l'organisation.

AuthorizationError

CUSTOMER_NOT_ENABLED
RésuméLe compte client est inaccessible, car il n'est pas activé.
Causes courantesCela se produit lorsque le compte client n'a pas été finalisé ou a été désactivé.
Comment gérerConnectez-vous à l'interface utilisateur de 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éventionVous pouvez vérifier de manière proactive si un compte client est désactivé en vérifiant si son état est ANNULÉ.
DEVELOPER_TOKEN_NOT_APPROVED
RésuméLe jeton de développeur n'est autorisé qu'à être utilisé avec des comptes de test, et vous avez tenté d'accéder à un compte qui n'est pas un compte de test.
Causes courantesUn jeton de développeur de test a été utilisé pour accéder à un compte non de test.
Comment gérerAssurez-vous de vouloir accéder à un compte non de test. Si c'est le cas, vous devez demander à faire passer votre jeton de développeur à un accès standard ou de base.
Conseils de préventionN/A
DEVELOPER_TOKEN_PROHIBITED
RésuméLe jeton de développeur n'est pas autorisé avec le projet envoyé dans la requête.
Causes courantesChaque projet de la console Google APIs ne peut être associé qu'au jeton de développeur d'un seul compte administrateur. Une fois que vous avez envoyé une requête API Google Ads, le jeton de développeur est associé de manière permanente au projet de la console Google APIs. Si vous n'utilisez pas de nouveau projet Google API Console, une erreur DEVELOPER_TOKEN_PROHIBITED s'affichera lorsque vous enverrez une requête.
Comment gérerN/A
Conseils de préventionSi 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 de l'API Google Ads qui utilisent le jeton du nouveau compte administrateur.
USER_PERMISSION_DENIED
RésuméLe client autorisé n'a pas accès au client exploitant.
Causes courantesAuthentification en tant qu'utilisateur disposant d'un accès à un compte administrateur, mais sans spécifier login-customer-id dans la requête.
Comment gérerN/A
Conseils de préventionSpécifiez login-customer-id comme ID de compte administrateur sans tirets (-). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.