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 d'erreur. 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 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.
Comment gérer Assurez-vous que le jeton d'accès dispose des autorisations requises. Cette erreur se produit généralement lorsque vous réutilisez un jeton d'accès existant généré avec un ensemble différent d'autorisations OAuth. Pour obtenir un exemple de génération d'un jeton d'accès avec les autorisations requises, consultez les paramètres d'autorisation OAuth.
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 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.
Comment gérer 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 ID client incorrect.
Comment gérer N/A
Conseils de prévention 123-456-7890 doit ê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 Non-spécification d'un ID client dans l'en-tête HTTP.
Comment gérer N/A
Conseils de prévention L'ID client est requis 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 l'ID 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.
Comment gérer 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é.
Comment gérer 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é.
Comment gérer 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 (Outils et paramètres > Accès et sécurité), 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.
Comment gérer 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 du compte administrateur. Consultez le guide d'authentification des utilisateurs.
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 courantes Le jeton de développeur n'est pas associé à un projet Google Cloud dans la même organisation Google Cloud que le projet Google Cloud utilisé initialement pour effectuer des requêtes.
Comment gérer Assurez-vous que l'ID client OAuth est associé à des projets Google Cloud dans 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évention Assurez-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.
DEVELOPER_TOKEN_INVALID
RésuméLe jeton de développeur n'est pas valide.
Causes courantes Cette erreur est généralement due à des fautes de frappe dans le jeton de développeur ou à une configuration incorrecte du jeton de développeur dans un autre en-tête de requête.
Comment gérer Assurez-vous de copier le jeton de développeur depuis le centre d'API pour éviter les fautes de frappe. Vous trouverez le centre d'API dans votre compte administrateur Google Ads. Assurez-vous également de définir le jeton de développeur dans l'en-tête approprié. Les jetons de développeur sont parfois confondus avec les jetons d'actualisation OAuth et les codes d'autorisation. Pour en savoir plus sur les différents en-têtes de requête, cliquez ici.
Conseils de prévention N/A

AuthorizationError
CUSTOMER_NOT_ENABLED
RésuméIl est 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é.
Comment gérer 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 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É.
DEVELOPER_TOKEN_NOT_APPROVED
RésuméLe jeton de développeur n'est approuvé que pour une utilisation avec des comptes de test et a tenté d'accéder à un compte autre qu'un compte de test.
Causes courantes Un jeton de développeur de test a été utilisé pour accéder à un compte autre qu'un compte de test.
Comment gérer Assurez-vous que vous souhaitez réellement accéder à un compte autre qu'un compte de test. Si c'est le cas, vous devez demander à ce que votre jeton de développeur soit mis à niveau vers 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é qu'au jeton de développeur d'un seul compte administrateur. Une fois que vous avez effectué 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 de la console Google APIs, vous recevrez une erreur DEVELOPER_TOKEN_PROHIBITED lorsque vous effectuerez une requête.
Comment gérer N/A
Conseils de prévention Si vous passez à un jeton de développeur sous 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 nouvel administrateur.
USER_PERMISSION_DENIED
RésuméLe client autorisé n'a pas accès au client d'exploitation.
Causes courantes Authentification en tant qu'utilisateur ayant accès à un compte administrateur, mais sans spécifier login-customer-id dans la requête.
Comment gérer 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