Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
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 courantes
La 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érer
Assurez-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évention
Assurez-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 courantes
Un 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é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 en suivant ces instructions pour éviter que le jeton d'actualisation n'expire dans sept jours.
Cet opérateur ne peut pas être utilisé avec une sous-classe d'annonce.
Causes courantes
Vous essayez de modifier des attributs autres que l'status de l'annonce.
Comment gérer
N/A
Conseils de prévention
Une fois une annonce créée, vous ne pouvez plus la modifier. Si vous souhaitez modifier l'annonce, vous devez en créer une nouvelle, puis supprimer l'ancienne. Toutefois, le status de l'annonce peut être modifié à l'aide de MutateAdGroupAds.
INVALID_INPUT
Résumé
L'un des champs d'une annonce contient des caractères non valides.
Causes courantes
Utilisation de caractères spéciaux dans les URL
Comment gérer
N/A
Conseils de prévention
Validez les URL dans votre application avant d'envoyer la requête API.
Vous essayez d'ajouter ou de renommer un groupe d'annonces, mais le nom est déjà utilisé par un autre groupe d'annonces.
Causes courantes
Créer un groupe d'annonces portant le nom d'un groupe d'annonces actif ou en veille existant
Comment gérer
Enregistrez l'erreur et présentez un message d'erreur à l'utilisateur, en suggérant éventuellement un nom de groupe d'annonces unique ou en affichant la liste des noms utilisés.
Deux opérations dans une même requête contiennent une opération de création pour un composant avec les mêmes données binaires.
Causes courantes
Requête de modification avec des opérations de création en double contenant les mêmes données binaires.
Comment gérer
Créez l'asset dans une requête distincte, puis associez-le dans la requête suivante. Vous pouvez également utiliser un ID temporaire dans la même requête.
123-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 courantes
Vous n'avez pas spécifié d'ID client client dans l'en-tête HTTP.
Comment gérer
N/A
Conseils de prévention
L'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 courantes
Vous essayez d'accéder à un compte qui vient d'être créé avant qu'il ne soit établi dans le backend.
Comment gérer
Patientez 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 sujet.
GOOGLE_ACCOUNT_COOKIE_INVALID
Résumé
Le jeton d'accès dans l'en-tête de la 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 dans 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, 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 valide.
Comment gérer
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 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 courantes
Le 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érer
Assurez-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é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.
Le compte client est inaccessible, car il n'est pas activé.
Causes courantes
Cela se produit lorsque le compte client n'a pas été finalisé ou a été désactivé.
Comment gérer
Connectez-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évention
Vous 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 courantes
Un jeton de développeur de test a été utilisé pour accéder à un compte non de test.
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 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érer
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 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 courantes
Authentification 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érer
N/A
Conseils de prévention
Spécifiez login-customer-id comme ID de compte administrateur sans tirets (-). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.
La valeur de l'enchère n'est pas un multiple exact de l'unité minimale de la devise du compte. Par exemple, 0,015 USD (15000 en micros) n'est pas une enchère valide.
Causes courantes
N/A
Comment gérer
N/A
Conseils de prévention
Vérifiez que les enchères sont des multiples de l'unité minimale de la devise du compte.
BID_TOO_BIG
Résumé
L'erreur est renvoyée même si l'enchère est inférieure au budget de la campagne.
Vous essayez d'ajouter ou de renommer une campagne, mais le nom est déjà utilisé par une autre campagne.
Causes courantes
Créer une campagne avec le nom d'une campagne active ou mise en veille existante
Comment gérer
Enregistrez l'erreur et présentez un message d'erreur à l'utilisateur, en lui suggérant éventuellement un nom de campagne unique ou en affichant la liste des noms utilisés.
La requête contient deux paramètres identiques et redondants.
Causes courantes
N/A
Comment gérer
N/A
Conseils de prévention
Supprimez les doublons (opérations, paramètres, éléments de liste) avant d'effectuer la requête. Recherchez les champs contenant la contrainte DistinctElements.
La requête a expiré et n'a pas pu être traitée assez rapidement pour renvoyer une réponse.
Causes courantes
Une requête de recherche a généré une réponse trop volumineuse, ou une requête de modification était trop volumineuse pour être traitée.
Comment gérer
Attendez environ 30 secondes, puis envoyez de nouveau la demande. Si l'erreur persiste, essayez de diviser la requête en plusieurs requêtes plus petites qui peuvent être traitées plus rapidement.
Une erreur inattendue s'est produite lors du traitement de la demande.
Causes courantes
L'API ne fonctionne pas correctement en raison d'un bug.
Comment gérer
Réessayez les requêtes ayant échoué avec cette erreur, en appliquant un calendrier d'intervalle exponentiel entre les tentatives.
Conseils de prévention
N/A
TRANSIENT_ERROR
Résumé
Une erreur interne temporaire s'est produite. Vous devez réessayer.
Causes courantes
Cette erreur se produit lorsque l'API rencontre un problème temporaire en interne.
Comment gérer
Réessayez les requêtes ayant échoué avec cette erreur, en appliquant un calendrier d'intervalle exponentiel entre les tentatives.
Conseils de prévention
N/A
InvalidGrantError
invalid_grant (malformed auth code)
Résumé
Le code d'autorisation échangé contre des jetons OAuth était mal formé.
Causes courantes
Cela se produit lorsque vous essayez de générer un jeton d'actualisation pour un utilisateur auquel l'accès à l'application à l'origine de la demande a déjà été accordé. Par exemple, cela peut se produire lorsque vous exécutez l'exemple de génération d'identifiants utilisateur plusieurs fois pour les mêmes identifiants client OAuth et l'utilisateur autorisant.
Comment gérer
Pour générer à nouveau un jeton d'actualisation pour une combinaison donnée d'utilisateur d'autorisation et d'identifiants de client OAuth, révoquez un jeton d'actualisation existant. Notez que si vous révoquez un jeton, il ne peut plus être utilisé pour accéder à l'API Google Ads et tous les jetons d'accès générés à l'aide du jeton d'actualisation sont invalidés.
Conseils de prévention
Veillez à stocker votre jeton d'actualisation dans un emplacement sécurisé pour éviter d'avoir à le générer à nouveau.
La requête faisait référence à une ressource introuvable.
Causes courantes
La requête a tenté de modifier ou de référencer une ressource qui n'existe pas ou qui a été supprimée. Ou le nom de la ressource donné n'est pas conforme.
Comment gérer
Utilisez une requête de recherche pour récupérer le nom d'une ressource existante avant d'envoyer une requête de modification. Consultez nos guides sur la bibliothèque cliente, qui incluent des instructions sur la création de noms de ressources valides dans chaque langue prise en charge.
Conseils de prévention
Ne créez pas de noms de ressources manuellement. Utilisez l'une des méthodes d'assistance proposées par nos bibliothèques clientes.
La requête tente de créer une ressource qui entraînerait un dépassement de la limite spécifiée pour le nombre total de ces ressources.
Causes courantes
Le nombre de ressources pouvant exister dans certains contextes est limité de plusieurs façons.
Comment gérer
Identifiez la limite rencontrée en consultant la section Limites du système. Réutilisez une ressource existante ou supprimez des ressources pour libérer de l'espace pour de nouvelles ressources.
Conseils de prévention
Utilisez des requêtes de recherche pour surveiller le nombre de ressources soumises à des limites.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/06/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/06/04 (UTC)."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]