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 informations de référence 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 niveaux d'accès requis. Cette erreur se produit souvent lorsque vous réutilisez un jeton d'accès existant qui a été généré à l'aide d'un ensemble différent de champs d'application OAuth. Consultez les paramètres d'autorisation OAuth pour obtenir un exemple de génération d'un jeton d'accès avec les champs d'application requis. Conseils de prévention Assurez-vous que le jeton d'accès dispose des niveaux d'accès requis. Réauthentifiez votre utilisateur avec les niveaux d'accès requis pour obtenir un accès avec les niveaux d'accès requis. Si votre application utilise plusieurs niveaux d'accès 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. Le jeton d'actualisation expire donc tous les sept jours et génère une erreur invalid_grant. Accédez à la console Google APIs, puis à l'écran d'autorisation OAuth. Ensuite, définissez l'état de publication sur In production en suivant ces instructions pour éviter que le jeton d'actualisation n'expire au bout de 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 Vous essayez de modifier des attributs autres que status dans l'annonce. Comment gérer N/A Conseils de prévention Une fois une annonce créée, elle ne peut plus être modifiée. Si vous souhaitez modifier l'annonce, vous devez en créer une autre et 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 Utiliser des 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.
LINE_TOO_WIDE	Résumé La longueur de l'un des champs d'une annonce dépassait la limite autorisée. Consultez À propos des annonces textuelles. Causes courantes La ligne de texte est trop longue. Comment gérer 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 des annonces. Causes courantes Vous essayez d'associer le libellé à des annonces qui le sont déjà. Comment gérer 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, vous ne pouvez plus la modifier, y compris son état. Comment gérer 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 Ajouter des mots clés. Causes courantes Le texte du mot clé contient des caractères non valides. Comment gérer N/A Conseils de prévention Validez le texte du mot clé dans votre application avant d'envoyer une requête à 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 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 lui suggérant éventuellement un nom de groupe d'annonces unique ou en lui montrant la liste des noms déjà utilisés. Conseils de prévention N/A

AssetError

DUPLICATE_ASSET

Résumé 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 mutate avec des opérations de création en double contenant les mêmes données binaires. Comment gérer Créez le composant 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. Conseils de prévention N/A

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Résumé Le numéro client n'est pas un nombre. Causes courantes Vous utilisez un numéro client incorrect. Comment gérer N/A Conseils de prévention 123-456-7890 doit être remplacé par 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 Ne pas spécifier de numéro client dans l'en-tête HTTP. Comment gérer N/A Conseils de prévention L'ID 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 cette opération pour vous.
CUSTOMER_NOT_FOUND	Résumé Aucun compte trouvé pour le numéro 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 Patientez quelques minutes après la création du compte avant d'envoyer des requêtes.
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 pour lequel Google Ads n'est pas activé. Comment gérer 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 en vous connectant à votre compte administrateur, en sélectionnant le compte client ou administrateur concerné, 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 correct. Comment gérer N/A Conseils de prévention Assurez-vous d'avoir transmis le bon 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 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 dans la même organisation Google Cloud que le projet Google Cloud utilisé pour envoyer les requêtes à l'origine. Comment gérer Si vous avez déjà envoyé des requêtes API avec le jeton de développeur, assurez-vous que l'ID client OAuth est associé à des projets Google Cloud de la même organisation Google Cloud. 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 Veillez à 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 le bon en-tête. Les jetons de développeur sont parfois confondus avec les jetons d'actualisation et les codes d'autorisation OAuth. 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é Le compte client est inaccessible, car il n'est pas activé. Causes courantes Cela se produit lorsque le client n'a pas terminé de s'inscrire ou que son compte 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. 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 les comptes de test et a 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 qui n'est pas un compte de test. Comment gérer Assurez-vous de vouloir accéder à un compte non test. Si c'est le cas, vous devez demander à ce que votre jeton de développeur soit mis à niveau pour bénéficier d'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 demande. 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 à l'API Google Ads, le jeton de développeur est associé de manière permanente au projet Google API Console. Si vous n'utilisez pas un nouveau projet Google APIs Console, vous recevrez une erreur DEVELOPER_TOKEN_PROHIBITED lorsque vous enverrez 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 de l'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 opérationnel. 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 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 n'est pas un multiple exact de l'unité minimale de la devise du compte. Par exemple, une enchère de 0,015 USD (15000 en micros) n'est pas 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 comprise dans le budget de la campagne. Causes courantes N/A Comment gérer N/A Conseils de prévention Vérifiez si le compte participe au programme Google Ad Grants. Si c'est le cas, limitez les enchères au CPC au maximum 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 Comment gérer N/A Conseils de prévention Vérifiez que le montant du budget est supérieur ou égal à l'unité minimale pour la devise du compte.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Résumé Le montant du budget comportera trop de décimales significatives lorsqu'il sera converti d'un montant en micro-unité vers un montant dans la devise du compte. Causes courantes N/A Comment gérer N/A Conseils de prévention Vérifiez que le montant du budget est divisible par l'unité minimale de 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 portant le nom d'une campagne active ou 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 lui montrant la liste des noms déjà utilisés. Conseils de prévention N/A

CriterionError
KEYWORD_HAS_INVALID_CHARS	Résumé Ajouter ou modifier des mots clés contenant des caractères non valides Causes courantes Utilisez des caractères spéciaux tels que ! @ % * dans les mots clés. Comment gérer N/A Conseils de prévention Assurez-vous de ne pas utiliser de caractères non autorisés dans les mots clés. Consultez Ajouter des mots clés.

DistinctError
DUPLICATE_ELEMENT	Résumé 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'envoyer la requête. Recherchez les champs qui comportent 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 requête de recherche a généré une réponse trop volumineuse, ou une requête de mutation é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 petites requêtes qui peuvent être traitées plus rapidement. Conseils de prévention Consultez Segmentation pour comprendre comment elle peut affecter la taille d'une réponse. Tenez compte des limites de la couche de transport gRPC.
INTERNAL_ERROR	Résumé 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 Relancez 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. Vous devez réessayer. Causes courantes Cette erreur se produit lorsque l'API rencontre un problème temporaire en interne. Comment gérer Relancez 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 code d'autorisation échangé contre des jetons OAuth était mal formé. Causes courantes Cela se produit lorsque vous tentez de générer un jeton d'actualisation pour un utilisateur qui a déjà été autorisé à accéder à l'application demandée. 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 le même utilisateur autorisé. Comment gérer Pour générer un jeton d'actualisation pour une combinaison donnée d'identifiants d'utilisateur autorisé et de 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 que le jeton d'actualisation a permis de générer. Conseils de prévention Assurez-vous de stocker votre jeton d'actualisation dans un endroit sûr pour éviter d'avoir à le régénérer.

MutateError

RESOURCE_NOT_FOUND

Résumé La requête faisait référence à une ressource introuvable. Causes courantes La demande 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 n'est pas conforme. Comment gérer Utilisez une demande de recherche pour récupérer le nom de ressource 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 façon de créer des noms de ressources valides dans chaque langage compatible. 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.

NotEmptyError
EMPTY_LIST	Résumé Une liste obligatoire est vide. Causes courantes Transmettre une liste d'opérations vide à une méthode mutate. Comment gérer 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 Comment gérer N/A Conseils de prévention Configurez de courts délais entre les requêtes ou combinez plusieurs opérations dans moins de requêtes.

RangeError
TOO_LOW	Résumé Une valeur était inférieure au minimum autorisé. Causes courantes Oublier de spécifier un ID, ce qui entraîne la transmission d'une valeur 0. Comment gérer N/A Conseils de prévention Notez les éventuelles limites de plage indiquées dans la documentation de référence de l'API.

RequestError
INVALID_INPUT	Résumé La requête est mal formulée. Causes courantes L'URL ou le contenu de la requête sont mal formulés. Comment gérer N/A Conseils de prévention N/A
REQUIRED_FIELD_MISSING	Résumé Il manque des informations obligatoires dans la demande. Causes courantes Des champs obligatoires sont manquants lors de la tentative d'ajout d'une entité. Comment gérer Enregistrez 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 Consultez la documentation de référence de l'API pour connaître les champs obligatoires.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Résumé 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é. Comment gérer Identifiez la limite rencontrée en consultant les limites du système. Réutilisez une ressource existante ou supprimez des ressources pour faire de la place à de nouvelles. Conseils de prévention Utilisez des requêtes de recherche pour surveiller le nombre de ressources qui présentent des limites.

StringLengthError
TOO_LONG	Résumé La chaîne attribuée au champ spécifié est plus longue que la limite. Causes courantes Les titres ou les descriptions des annonces contiennent trop de texte. Comment gérer Identifiez la limite rencontrée , modifiez la chaîne en conséquence, puis renvoyez la requête. Conseils de prévention Tenez compte des limites de longueur des chaînes.