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 traiter.
Pour obtenir la liste complète des erreurs, consultez les références relatives aux 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 arrivant à expiration 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 génère une erreur invalid_grant. Accédez à la console Google APIs, puis à l'écran de consentement OAuth. Définissez 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
Tentative de modification d'attributs autres que l'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 modifier l'annonce, vous devez en créer une autre, puis supprimer l'ancienne. En revanche, l'élément 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.
Gestion
N/A
Conseils de prévention
Validez les URL dans votre application avant d'envoyer la requête API.
Un groupe d'annonces est ajouté ou renommé, mais son 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 mis en veille
Gestion
Consignez l'erreur et présentez un message d'erreur à l'utilisateur, qui peut éventuellement suggérer un nom de groupe d'annonces unique ou afficher la liste des noms utilisés.
Deux opérations dans une même requête contiennent une opération de création pour un élément ayant les mêmes données binaires.
Causes courantes
Requête mutate avec des opérations de création dupliquées contenant les mêmes données binaires.
Gestion
Créez l'élément dans une demande distincte, puis associez-le dans la demande suivante. Vous pouvez également utiliser un ID temporaire dans la même demande.
123-456-7890 devrait ê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
Aucun numéro client client n'est spécifié dans l'en-tête HTTP.
Gestion
N/A
Conseils de prévention
Le numéro 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, 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.
Gestion
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 à son encontre.
GOOGLE_ACCOUNT_COOKIE_INVALID
Résumé
Le jeton d'accès indiqué dans l'en-tête de la 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 client ou le compte administrateur concerné, 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 figurant 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 rattachés à un compte administrateur, assurez-vous d'obtenir le jeton d'actualisation de ce compte. Pour en savoir plus, consultez notre guide sur les jetons d'accès et les jetons d'actualisation et sur OAuth2.
Impossible d'accéder au compte client, 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é.
Gestion
Connectez-vous à l'interface utilisateur Google Ads et assurez-vous d'avoir terminé le processus 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 le compte d'un client est désactivé en consultant l'état ANNULÉE.
DEVELOPER_TOKEN_NOT_APPROVED
Résumé
Le jeton de développeur n'est approuvé que pour une utilisation avec des comptes de test et une tentative d'accès à un compte non test.
Causes courantes
Un jeton de développeur test a été utilisé pour accéder à un compte qui n'est pas un compte 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é au jeton de développeur qu'à partir d'un seul compte administrateur. Lorsque vous envoyez une demande à l'API Google Ads, le jeton de développeur est associé en permanence 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 est renvoyée lorsque vous envoyez une requête.
Gestion
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 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 les traits d'union (-). Les bibliothèques clientes sont compatibles avec cette fonctionnalité.
La valeur de l'enchère ne correspond pas à un multiple exact de l'unité minimale de 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 pour la devise du compte.
BID_TOO_BIG
Résumé
L'erreur s'affiche même si l'enchère respecte le budget de la campagne.
Une campagne est en cours d'ajout ou de nom, mais son nom est déjà utilisé par une autre campagne.
Causes courantes
Créer une campagne portant le nom d'une campagne active ou mise en veille existante
Gestion
Consignez l'erreur et présentez un message d'erreur à l'utilisateur, en lui suggérant un nom de campagne unique ou en affichant la liste des noms utilisés (facultatif).
La requête 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.
La requête a expiré et n'a pas pu être traitée suffisamment rapidement pour renvoyer une réponse.
Causes courantes
Une demande de recherche a été effectuée et a généré une réponse trop volumineuse, 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 diviser la requête en plusieurs petites requêtes pouvant ê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.
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. Veuillez réessayer.
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 code d'autorisation échangé contre des jetons OAuth était incorrect.
Causes courantes
Cela se produit lorsque vous tentez de générer un jeton d'actualisation pour un utilisateur ayant déjà accès à l'application à l'origine de la demande. Cela peut se produire lorsque vous exécutez l'exemple Générer des identifiants d'utilisateur plusieurs fois pour les mêmes identifiants client OAuth et l'autorisation d'utilisateur.
Gestion
Afin de générer à nouveau un jeton d'actualisation pour une combinaison donnée d'identifiants utilisateur et client OAuth d'autorisation, 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 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.
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 donné pour la ressource est incorrect.
Gestion
Utilisez une requête de recherche pour récupérer le nom de ressource d'une ressource existante avant d'envoyer une demande mutate. Consultez les guides de la bibliothèque cliente, qui expliquent comment créer des noms de ressources valides dans toutes les langues acceptées.
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 le 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 soumis à plusieurs limites.
Gestion
Identifiez la limite qui est rencontrée en consultant les limites du système. Réutilisez une ressource existante ou supprimez des ressources 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 limitées.
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 qui se pose, modifiez la chaîne en conséquence et renvoyez la requête.
Conseils de prévention
Tenez compte des limites de longueur des chaînes.
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 2024/06/26 (UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Il n'y a pas l'information dont j'ai besoin"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Trop compliqué/Trop d'étapes"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Obsolète"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problème de traduction"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Mauvais exemple/Erreur de code"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Autre"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile à comprendre"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"J'ai pu résoudre mon problème"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Autre"
}]
{
"last_modified": "Dernière mise à jour le 2024/06/26 (UTC).",
"state": ""
}