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.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Résumé Cet opérateur ne peut pas être utilisé avec une sous-classe d'annonce. Causes courantes Tentative de modification d'attributs autres que l'attribut status de l'annonce. Gestion N/A Conseils de prévention Une fois qu'une annonce est créée, vous ne pouvez plus la modifier. Si vous souhaitez la modifier, vous devez en créer une autre, puis supprimer l'ancienne. Toutefois, vous pouvez modifier le status de l'annonce à 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 Gestion N/A Conseils de prévention Validez les URL dans votre application avant d'envoyer la requête API.
LINE_TOO_WIDE	Résumé L'un des champs d'une annonce dépassait la longueur maximale autorisée. Consultez À propos des annonces textuelles. Causes courantes Ligne de texte trop longue. Gestion N/A Conseils de prévention Validez la longueur de la ligne avant d'envoyer la requête API.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Résumé Ce libellé est déjà associé à certaines annonces. Causes courantes Tentative d'association du libellé à des annonces qui ont déjà été associées. Gestion N/A Conseils de prévention Vérifiez d'abord si le libellé à ajouter est déjà associé aux annonces.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Résumé Une opération a tenté de mettre à jour une annonce supprimée. Causes courantes Une fois qu'une annonce est supprimée, elle ne peut plus être mise à jour, ni même son état. Gestion N/A Conseils de prévention Assurez-vous que votre code ne tente pas de mettre à jour les annonces supprimées.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Résumé Le texte du mot clé contient des caractères non valides. Consultez l'article Ajouter des mots clés. Causes courantes Le texte du mot clé contient des caractères non valides. Gestion N/A Conseils de prévention Validez le texte du mot clé dans votre application avant d'envoyer une demande à l'API.

AdGroupError

DUPLICATE_ADGROUP_NAME

Résumé Un groupe d'annonces est en cours d'ajout ou de changement de nom, mais le nom est déjà utilisé par un autre groupe d'annonces. Causes courantes Créer un groupe d'annonces avec le nom d'un groupe d'annonces actif ou mis en veille existant Gestion Consignez l'erreur et présentez un message d'erreur à l'utilisateur, en lui suggérant éventuellement un nom de groupe d'annonces unique ou en affichant la liste des noms utilisés. Conseils de prévention N/A

AssetError

DUPLICATE_ASSET

Résumé Deux opérations d'une même requête contiennent une opération de création pour un élément avec les mêmes données binaires. Causes courantes Une demande mutate avec des opérations de création en double contenant les mêmes données binaires. Gestion Créez le composant dans une demande distincte, puis associez-le dans la demande suivante ou utilisez un ID temporaire dans la même demande. Conseils de prévention N/A

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.
GOOGLE_ACCOUNT_COOKIE_INVALID	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é.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Résumé La valeur de l'enchère ne correspond pas à un multiple exact de l'unité minimale dans la devise du compte. Par exemple, 0,015 € (15000 en micros) n'est pas une enchère valide. Causes courantes N/A Gestion N/A Conseils de prévention Vérifiez que les enchères sont des multiples de l'unité minimale définie dans la devise du compte.
BID_TOO_BIG	Résumé L'erreur est renvoyée même si l'enchère respecte le budget de la campagne. Causes courantes N/A Gestion N/A Conseils de prévention Vérifiez si le compte fait partie du programme Google Ad Grants. Si tel est le cas, limitez les enchères au CPC au maximal prescrit par le programme.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Résumé Le montant du budget est trop faible. Causes courantes N/A Gestion N/A Conseils de prévention Vérifiez que le montant du budget est supérieur ou égal à l'unité minimale définie dans la devise du compte.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Résumé Le budget comporte trop de chiffres après la virgule lorsqu'il est converti d'un montant en micro-montant dans la devise du compte. Causes courantes N/A Gestion N/A Conseils de prévention Vérifiez que le montant du budget est divisible par l'unité minimale dans la devise du compte.

CampaignError

DUPLICATE_CAMPAIGN_NAME

Résumé Une campagne est en cours d'ajout ou de changement de nom, 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 Gestion Consignez l'erreur, puis 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. Conseils de prévention N/A

CriterionError
KEYWORD_HAS_INVALID_CHARS	Résumé Ajout ou modification de mots clés contenant des caractères non valides. Causes courantes Utilisez des caractères spéciaux comme ! @ % * dans les mots clés. Gestion N/A Conseils de prévention Veillez à ne pas utiliser de caractères non autorisés dans les mots clés. Consultez l'article Ajouter des mots clés.

DistinctError
DUPLICATE_ELEMENT	Résumé La demande contient deux paramètres identiques et redondants. Causes courantes N/A Gestion N/A Conseils de prévention Supprimez les doublons (opérations, paramètres, éléments de liste) avant d'envoyer la requête. Recherchez les champs comportant la contrainte DistinctElements.

InternalError
DEADLINE_EXCEEDED	Résumé La requête a expiré et n'a pas pu être traitée assez rapidement pour renvoyer une réponse. Causes courantes Une demande de recherche ayant généré une réponse trop volumineuse a été effectuée, ou une demande mutate était trop volumineuse pour être traitée. Gestion Attendez environ 30 secondes, puis envoyez de nouveau la demande. Si l'erreur persiste, essayez de la diviser en plusieurs petites requêtes, plus petites, qui pourront être traitées plus rapidement. Conseils de prévention Consultez la section Segmentation pour comprendre comment elle peut influer sur la taille d'une réponse. Tenez compte des limites de la couche transport gRPC.
INTERNAL_ERROR	Résumé Une erreur inattendue s'est produite lors du traitement de la requête. Causes courantes L'API ne fonctionne pas correctement en raison d'un bug. Gestion Relancez toutes les requêtes ayant échoué avec cette erreur, en utilisant un intervalle exponentiel entre les tentatives. Conseils de prévention N/A
TRANSIENT_ERROR	Résumé Une erreur interne temporaire s'est produite, une nouvelle tentative doit être effectuée. Causes courantes Cette erreur se produit lorsque l'API rencontre un problème temporaire en interne. Gestion Relancez toutes les requêtes ayant échoué avec cette erreur, en utilisant un intervalle exponentiel entre les tentatives. Conseils de prévention N/A

InvalidGrantError

invalid_grant (malformed auth code)

Résumé Le format du code d'autorisation échangé contre des jetons OAuth était incorrect. Causes courantes Cela se produit lors d'une tentative de génération d'un jeton d'actualisation pour un utilisateur déjà autorisé à accéder à l'application à l'origine de la demande. Cela peut se produire lorsque vous exécutez l'exemple Générer des identifiants utilisateur plusieurs fois pour les mêmes identifiants client OAuth et que vous autorisez l'utilisateur. Gestion Afin de générer à nouveau un jeton d'actualisation pour une combinaison donnée d'identifiants utilisateur autorisés et client OAuth, révoquez un jeton d'actualisation existant. Notez que la révocation d'un jeton le rend inutilisable pour l'accès à l'API Google Ads et invalide tous les jetons d'accès générés par le jeton d'actualisation. Conseils de prévention Veillez à stocker votre jeton d'actualisation dans un emplacement sécurisé pour éviter d'avoir à le générer de nouveau.

MutateError

RESOURCE_NOT_FOUND

Résumé La requête fait 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 ressource donné pour la ressource est incorrect. Gestion Utilisez une requête de recherche pour récupérer le nom d'une ressource existante avant d'envoyer une demande de mutation. Consultez nos guides sur les bibliothèques clientes, qui incluent de la documentation sur la création de noms de ressources valides dans chaque langage accepté. Conseils de prévention Ne créez pas de noms de ressources manuellement. utiliser l'une des méthodes d'assistance proposées par nos bibliothèques clientes ;

NotEmptyError
EMPTY_LIST	Résumé Une liste obligatoire est vide. Causes courantes Transmettre une liste d'opérations vide à une méthode mutate Gestion N/A Conseils de prévention N/A

QuotaError
RESOURCE_EXHAUSTED	Résumé Une limite de fréquence du système a été dépassée. Causes courantes N/A Gestion N/A Conseils de prévention Configurez des délais courts entre les requêtes ou combinez davantage d'opérations en moins de requêtes.

RangeError
TOO_LOW	Résumé Une valeur était inférieure au minimum autorisé. Causes courantes Vous avez oublié de spécifier un ID ? La valeur 0 est donc transmise. Gestion N/A Conseils de prévention Notez toutes les limites de plage indiquées dans la documentation de référence de l'API.

RequestError
INVALID_INPUT	Résumé Le format de la demande est incorrect. Causes courantes Le format de l'URL ou du contenu de la demande est incorrect. Gestion N/A Conseils de prévention N/A
REQUIRED_FIELD_MISSING	Résumé Des informations requises ne sont pas spécifiées dans la requête. Causes courantes Champs obligatoires manquants lors de la tentative d'ajout d'une entité. Gestion Consignez l'erreur et présentez un message d'erreur à l'utilisateur. L'attribut fieldPath de l'erreur indique le champ manquant. Conseils de prévention Pour savoir quels champs sont obligatoires, consultez la documentation de référence de l'API.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Résumé La requête tente de créer une ressource qui entraînerait le dépassement d'une limite spécifiée pour le nombre total de ces ressources. Causes courantes Le nombre de ressources pouvant exister dans certains contextes est limité. Gestion Identifiez la limite actuellement atteinte en consultant les limites du système. Réutilisez une ressource existante ou supprimez-en afin de 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 présentant des limites.

StringLengthError
TOO_LONG	Résumé La chaîne attribuée au champ spécifié dépasse la limite. Causes courantes Les titres ou descriptions des annonces contiennent trop de texte. Gestion Identifiez la limite rencontrée , modifiez la chaîne en conséquence, puis renvoyez la demande. Conseils de prévention Tenez compte des limites de longueur des chaînes.