Codes d’erreur HTTP de l’API d’indexation Google : les comprendre
Décodez les erreurs HTTP de l'API d'indexation Google (400, 401, 403, 429...) pour diagnostiquer vite et débloquer vos notifications d'URL.
Quand un appel à l’API d’indexation échoue, Google renvoie un code d’état HTTP accompagné d’un message d’erreur structuré. Savoir lire ces réponses transforme un blocage opaque en correction rapide. La page de référence classe les erreurs par code d’état HTTP, selon la norme RFC 7231, et une 429 renvoie souvent à la demande d’un quota supérieur.
Pour le SEO, c’est un gain de temps direct : une erreur 403 ne se traite pas comme une 429, et confondre les deux fait perdre des heures. Bien diagnostiquer évite que des pages éligibles restent hors de l’index lorsque vous cherchez à notifier l’ajout ou la suppression de pages.
Savoir lire un code d’erreur HTTP, c’est la différence entre un blocage opaque et une correction en cinq minutes. La confusion que je vois le plus, c’est traiter une 403 comme une 429 : l’une est un problème d’autorisation, l’autre un dépassement de quota, et les confondre fait perdre des heures. Lisez le code avant de toucher au code, sinon des pages éligibles restent hors de l’index pour rien.
Comment se présente une erreur
Une erreur globale est communiquée dans une réponse JSON qui contient un objet error : une liste d’erreurs (avec domain, reason, message et localisation), un code d’état et un message global. La propriété domain vaut souvent global, mais certaines API définissent leur propre domaine pour des erreurs spécifiques.
{
"error": {
"errors": [
{
"domain": "global",
"reason": "invalidParameter",
"message": "Invalid string value: 'asdf'.",
"locationType": "parameter",
"location": "chart"
}
],
"code": 400,
"message": "Invalid string value: 'asdf'."
}
}Les principaux codes d'état HTTP
Les erreurs sont regroupées par code d’état HTTP. Certains relèvent de redirections, d’autres d’un problème de requête, d’autorisation, de quota ou du serveur. Le tableau ci-dessous présente les familles les plus utiles à connaître pour l’API d’indexation.
| Code HTTP | Nom | Ce qu'il signifie |
|---|---|---|
400 |
BAD_REQUEST |
Requête non valide ou mal formulée (paramètre, en-tête ou propriété) |
401 |
UNAUTHORIZED |
Identifiants d’autorisation invalides ou session expirée |
403 |
FORBIDDEN |
Opération interdite, accès non configuré ou quota dépassé |
404 |
NOT_FOUND |
Ressource associée à la requête introuvable |
429 |
TOO_MANY_REQUESTS |
Trop de requêtes envoyées sur une période donnée |
500 |
INTERNAL_SERVER_ERROR |
Échec dû à une erreur interne du serveur |
503 |
SERVICE_UNAVAILABLE |
Erreur de backend ou serveur non prêt |
Les erreurs propres à l'API d'indexation
Au-delà des erreurs globales, l’API d’indexation définit ses propres messages. Dans tous ces cas, la requête est refusée et Google n’explore pas l’URL : pensez à vérifier la propriété validée lors de l’étape pour créer un compte de service. Le tableau ci-dessous reprend les messages les plus fréquents et leur cause concrète.
| Code HTTP | Message | Cause |
|---|---|---|
400 |
Missing attribute. ‘url’ attribute is required. |
L’attribut url n’a pas été défini dans la requête |
400 |
Invalid attribute. ‘url’ is not in standard URL format |
L’URL fournie ne respecte pas le format standard |
400 |
Unknown type. ‘type’ attribute is required… |
Le type de notification n’a pas été défini |
403 |
Permission denied. Failed to verify the URL ownership. |
La propriété de l’URL n’est pas validée ou ne vous appartient pas |
429 |
Insufficient tokens for quota ‘…default_requests’ |
Vous dépassez votre quota d’API d’indexation |
Une erreur 403 Permission denied signale un problème de propriété : le compte de service n’est pas propriétaire validé de l’URL. Une erreur 429 signale un dépassement de quota : il faut espacer les envois ou demander un quota supérieur. Inverser le diagnostic vous fera corriger le mauvais point.
À faire
- lire le code d’état HTTP et le champ reason
- vérifier la propriété du site pour une 403
- espacer les appels ou demander plus de quota pour une 429
- corriger l’attribut url ou type pour une 400
À éviter
- ignorer le message d’erreur détaillé
- relancer en boucle après une 429
- confondre une erreur d’autorisation et une erreur de quota
- renvoyer une URL mal formée
Points clés à retenir
- lisez le code d'état et le champ reason de la réponse
- une 400 vient d'une requête mal formée (url ou type)
- une 403 vient d'un problème de propriété ou d'accès
- une 429 signale un dépassement de quota
- une 500 ou 503 vient du serveur : réessayez plus tard
Chaque code HTTP oriente vers une cause précise.
Quiz : testez vos connaissances
Quiz : testez vos connaissances
-
Que signale une erreur 403 Permission denied de l'API d'indexation ?
- Vous avez dépassé votre quota de requêtes du jour
- Le compte de service n'est pas propriétaire validé de l'URL
- L'URL envoyée est mal formée ou absente
Une erreur 403 signale un problème de propriété : le compte de service n’a pas été validé comme propriétaire de l’URL, ou vous notifiez une URL qui ne vous appartient pas.
-
Que faut-il faire face à une erreur 429 ?
- Relancer l'appel en boucle jusqu'à ce qu'il passe
- Espacer ses requêtes et, si besoin, demander un quota supérieur
- Vérifier la propriété du site dans la Search Console
Une erreur 429 signale un dépassement de quota. Il faut espacer les requêtes, vérifier sa consommation et, si besoin, demander un quota supérieur via le formulaire officiel.
-
Comment savoir quel attribut pose problème dans une erreur 400 ?
- Le code 400 ne donne jamais de détail sur la cause
- Il faut deviner en testant chaque attribut un par un
- Le message d'erreur précise l'attribut concerné, souvent url ou type
Le message d’erreur précise l’attribut concerné, le plus souvent
urlmanquant ou mal formé, outypeabsent ou invalide.
À propos de l'auteur
Besoin d'un accompagnement SEO ?
Des erreurs bloquent vos notifications d'indexation et vous voulez y voir clair ?