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.
Réponse
Assurez-vous que le jeton d'accès dispose des champs d'application requis. Cette erreur est souvent due au fait que vous réutilisez un jeton d'accès existant qui a été généré à l'aide d'un autre ensemble de champs d'application OAuth. Consultez les paramètres d'autorisation OAuth pour obtenir un exemple de génération d'un nouveau jeton d'accès avec les champs d'application requis.
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 Testing reçoit un jeton d'actualisation qui expire au bout de sept jours.
Réponse
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 pour éviter que le jeton d'actualisation n'expire au bout de sept jours.
Cet opérateur ne peut pas être utilisé avec une sous-classe d'Ad.
Causes courantes
Tentative de modification d'attributs autres que le status de l'annonce.
Réponse
N/A
Conseils de prévention
Une fois qu'une annonce est créée, elle ne peut plus être modifiée. Si vous souhaitez modifier l'annonce, vous devez en créer une autre, puis supprimer l'ancienne. Toutefois, vous pouvez modifier le champ 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
Utiliser des caractères spéciaux dans les URL
Réponse
N/A
Conseils de prévention
Validez les URL dans votre application avant d'effectuer la requête API.
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éation d'un groupe d'annonces portant le nom d'un groupe d'annonces actif ou mis en veille existant.
Réponse
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.
Deux opérations d'une même requête contiennent une opération de création pour un asset avec les mêmes données binaires.
Causes courantes
Une requête de modification avec des opérations de création en double contenant les mêmes données binaires.
Réponse
Créez l'asset dans une requête distincte, puis associez-le dans la requête suivante, ou utilisez un ID temporaire dans la même requête.
Conseils de prévention
N/A
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE
Résumé
L'identifiant promotion du partenaire utilise une variante oneof (int_value ou string_value) que l'intégration de la promotion du compte n'accepte pas.
Causes courantes
Définir le champ promotion_asset.external_redeem_info.partner_promotion_id.int_value lorsque l'intégration de l'utilisation du client nécessite la variante string_value, ou définir le champ string_value lorsque l'intégration nécessite la variante int_value.
Vérifiez quel format d'identifiant de promotion (int_value ou string_value) votre intégration d'utilisation en point de vente utilise avant de créer un message PromotionAsset avec le champ external_redeem_info.
123-456-7890 doit être 1234567890. Pour en savoir plus, consultez Premiers pas.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Résumé
Le numéro client n'a pas été spécifié dans l'en-tête HTTP.
Causes courantes
Ne pas spécifier d'ID client dans l'en-tête HTTP.
Réponse
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 le numéro 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.
Réponse
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.
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 a été invalidé.
Réponse
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é.
Réponse
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 cela, 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 que vous avez transmis avec l'en-tête HTTP n'était pas correct.
Réponse
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 un identifiant permettant d'accéder à tous les comptes client d'un compte administrateur, veillez à obtenir le jeton d'actualisation du compte administrateur. Consultez le guide d'authentification des utilisateurs.
Le projet Google Cloud ne dispose que d'un accès de test et ne peut pas être utilisé pour accéder aux comptes de production.
Causes courantes
Un projet Google Cloud avec le niveau d'accès Test a été utilisé pour envoyer une requête à un compte Google Ads de production (autre que de test). (Dans les versions d'API v24 et antérieures, cette condition renvoie AuthorizationError.ACTION_NOT_PERMITTED.)
Réponse
Si vous effectuez des tests, assurez-vous que votre requête cible un compte de test. Si vous souhaitez accéder à un compte Google Ads de production, vérifiez le niveau d'accès de votre projet Google Cloud sur la page Vue d'ensemble de l'API Google Ads et passez au niveau d'accès Explorer, Basic ou Standard.
Conseils de prévention
N/A
CUSTOMER_NOT_ENABLED
Résumé
Le compte client n'est pas accessible, car il n'est pas activé.
Causes courantes
Cela se produit lorsque le compte client n'a pas terminé l'inscription ou a été désactivé.
Réponse
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 CANCELLED.
USER_PERMISSION_DENIED
Résumé
Le client autorisé n'a pas accès au client d'exploitation.
Causes courantes
Vous vous authentifiez en tant qu'utilisateur ayant accès à un compte administrateur, mais vous ne spécifiez pas login-customer-id dans la requête.
Réponse
N/A
Conseils de prévention
Spécifiez l'ID du compte administrateur login-customer-id 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
Réponse
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 respecte le budget de la campagne.
Une campagne est ajoutée ou renommée, mais son nom est déjà utilisé par une autre campagne.
Causes courantes
Création d'une campagne portant le nom d'une campagne existante active ou mise en veille.
Réponse
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.
Conseils de prévention
N/A
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Résumé
Tentative de modification du paramètre de type de correspondance des mots clés au niveau de la campagne pour une campagne où AI Max est activé.
Causes courantes
Lorsque AI Max est activé, les paramètres de requête large au niveau de la campagne sont obsolètes, car tous les mots clés sont traités comme des requêtes larges par défaut. Toute tentative de définition ou de modification de ce champ déclenchera l'erreur.
Réponse
Conseillez à l'utilisateur d'utiliser le paramètre "disable_search_term_matching" au niveau du groupe d'annonces au lieu de définir la requête large au niveau de la campagne.
Conseils de prévention
Évitez de définir `keyword_match_type` sur `BROAD` (ou toute autre valeur) dans la campagne si `ai_max_setting.enable_ai_max` est défini sur `true`. Activez ou désactivez la correspondance des termes de recherche au niveau du groupe d'annonces à l'aide de `disable_search_term_matching`.
Une campagne Demand Gen migrée ne peut pas être activée avant la suppression de la campagne d'origine, ni tant qu'une autre campagne migrée pour la même campagne d'origine est déjà active.
Causes courantes
Mise à jour de l'état (status) d'une campagne Demand Gen migrée sur ENABLED lorsque la campagne source d'origine n'est pas supprimée ou qu'une autre campagne Demand Gen migrée à partir de la même campagne d'origine est déjà définie sur ENABLED. Dans les versions v25 et antérieures de l'API, cette condition renvoie RequestError.UNKNOWN.
Réponse
Supprimez la campagne source d'origine à l'aide de CampaignOperation.remove (au préalable ou dans la même requête de modification) avant d'activer la campagne Demand Gen migrée, et vérifiez qu'aucune autre campagne Demand Gen migrée à partir de la même campagne d'origine n'est active. Pour en savoir plus, consultez Activer les campagnes migrées.
Conseils de prévention
Si vous suivez les ID de vos campagnes sources d'origine et de leurs campagnes Demand Gen migrées, interrogez campaign.status avant de définir status sur ENABLED pour une campagne migrée, ou incluez CampaignOperation.remove pour la campagne d'origine dans la même requête de modification.
La requête contient deux paramètres identiques et redondants.
Causes courantes
N/A
Réponse
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 associés à 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 été effectuée et a généré une réponse trop volumineuse, ou une requête de modification était trop volumineuse pour être traitée.
Réponse
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 requête.
Causes courantes
L'API ne fonctionne pas correctement en raison d'un bug.
Réponse
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. Une nouvelle tentative doit être effectuée.
Causes courantes
Cette erreur se produit lorsque l'API rencontre un problème temporaire en interne.
Réponse
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 n'était pas valide.
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 à l'origine de la requête. 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é.
Réponse
Pour regénérer un jeton d'actualisation pour une combinaison donnée d'utilisateur autorisant et d'identifiants 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 à l'aide du jeton d'actualisation.
Conseils de prévention
Veillez à stocker votre jeton d'actualisation dans un emplacement sécurisé pour éviter d'avoir à le régénérer.
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 ressource fourni pour la ressource est incorrect.
Réponse
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 les bibliothèques clientes, qui incluent de la documentation sur la création de noms de ressources valides dans tous les langages compatibles.
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 manières.
Réponse
Identifiez la limite rencontrée en consultant Limites du système. Réutilisez une ressource existante ou supprimez des ressources pour faire de la place pour de nouvelles.
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 2026/10/29 (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 2026/10/29 (UTC)."],[],[]]
