API Google Indexing expliquée : la solution GSC à essayer en premier
Par Toy Wen Da, Cofondateur · Mis à jour le · 7 min de lecture
Traduit de l'original en anglais. Lire en anglais
L'API Google Indexing vous permet de signaler directement à Google qu'une page est nouvelle, mise à jour ou supprimée. Google ajoute alors l'URL à une file d'exploration prioritaire, au lieu d'attendre de découvrir la modification par lui-même. L'API accélère l'exploration, mais ne garantit rien quant à l'indexation. Si une page affiche « Discovered, currently not indexed », essayez d'abord l'outil gratuit d'inspection d'URL de Search Console.
Ce que l'API fait et ne fait pas
Vous envoyez à Google une URL accompagnée d'un type de notification : URL_UPDATED ou URL_DELETED. Google place l'URL en file d'exploration avec une priorité supérieure à son calendrier habituel basé sur les sitemaps, mais le robot doit encore visiter la page et décider si elle mérite une place dans l'index.
Plusieurs choses échappent à ce que l'API peut faire :
- Elle ne peut pas indexer une URL directement ni contourner les signaux de qualité de Google : une page pauvre ou dupliquée n'entrera donc pas plus vite dans l'index.
- Elle n'a aucun effet sur le classement, car elle ne concerne que l'exploration.
- Elle ne remplace pas votre sitemap, qui doit continuer à porter l'essentiel de vos URL.
- Elle n'est pas officiellement prise en charge pour tous les types de contenu. En pratique, elle accepte d'autres URL, mais Google n'a pris aucun engagement sur la pérennité de ce fonctionnement.
L'idée reçue la plus courante est qu'une soumission réussie signifie que la page sera indexée. L'API fait en sorte que Google remarque la page plus tôt, mais rien en elle ne donne à Google l'envie de l'indexer.
Voir le problème d'abord : simuler Googlebot
Avant de toucher à Search Console ou à une API, vérifiez ce que Googlebot voit quand il visite la page. Beaucoup de problèmes d'« indexation » sont en réalité des problèmes de rendu ou de blocage : une balise noindex laissée par erreur, une règle du fichier robots.txt, ou du contenu JavaScript qui ne se charge jamais pour un robot d'exploration.
Passez la page dans le Googlebot Simulator gratuit. Il affiche le HTML rendu, les codes de statut et les éventuelles directives de blocage tels que le robot de Google les rencontre. S'il révèle une balise noindex ou une ressource bloquée, la corriger vous servira plus que n'importe quel appel d'API.
Corrigez d'abord dans Google Search Console
Pour presque toutes les plaintes du type « ma page ne s'indexe pas », les outils propres à Search Console sont le bon point de départ. La séquence ci-dessous couvre l'ensemble du processus.
Étape 1 : inspectez l'URL
Ouvrez Google Search Console, sélectionnez votre propriété et collez l'URL concernée dans l'outil d'inspection d'URL (URL Inspection) en haut de la page. Il vous indique si l'URL est sur Google, s'il existe une version explorée et quelle URL canonique Google a retenue.
Étape 2 : lisez attentivement le statut
Le statut de couverture indiqué par Search Console vous dit quoi faire ensuite.
| Statut dans Search Console | Ce que cela signifie | Que faire |
|---|---|---|
| Submitted and indexed | La page est en ligne dans l'index de Google | Aucune action nécessaire |
| Crawled, currently not indexed | Google l'a visitée mais a choisi de ne pas l'indexer | Améliorez la qualité du contenu, vérifiez la duplication |
| Discovered, currently not indexed | Google connaît l'URL mais ne l'a pas encore explorée | Demandez l'indexation ; sur les grands sites, vérifiez le budget d'exploration |
| URL is unknown to Google | Jamais vue auparavant | Soumettez-la via le sitemap et demandez l'indexation |
| Blocked by robots.txt | L'exploration est interdite au robot | Modifiez le fichier robots.txt |
| Alternate page with proper canonical tag | Google a indexé une autre URL comme canonique | Vérifiez l'existence de contenu dupliqué ou quasi dupliqué |
Étape 3 : demandez l'indexation
Si l'inspection montre que la page n'est pas indexée, cliquez sur Request Indexing. Google place l'URL en file d'exploration prioritaire, un peu comme pour l'API ; l'option est gratuite et se trouve dans la console que vous utilisez déjà.
Étape 4 : revenez vérifier, sans harceler
Attendez quelques jours avant de refaire une demande pour la même URL. Les demandes répétées sur une même page n'accélèrent rien et peuvent ressembler à de la manipulation aux yeux des systèmes de Google.
Quand Google Search Console suffit, et quand ce n'est pas le cas
Search Console suffit dans les cas suivants :
- Vous avez une page, ou une poignée de pages, bloquées dans « Discovered, currently not indexed ».
- Vous venez de publier un contenu et vous voulez qu'il soit pris en compte plus vite.
- Votre site compte quelques centaines ou quelques milliers d'URL, largement dans les limites d'un budget d'exploration normal.
Il vous faut autre chose, soit l'API Indexing, soit un service qui s'appuie dessus, dans les cas suivants :
- Vous gérez un site d'offres d'emploi ou d'événements dont les pages sont éligibles aux types de schémas
JobPostingouBroadcastEventque l'API prend officiellement en charge. - Vous gérez un gros sitemap de plusieurs dizaines de milliers d'URL, où les nouvelles pages restent enfouies pendant des semaines avant que l'exploration planifiée de Google ne les atteigne. Un cas documenté concerne un site e-commerce de 80 000 URL de produits, où les nouvelles fiches attendaient environ deux semaines avant leur première exploration ; faire passer les soumissions par l'API a ramené ce délai à moins de six heures.
- Vous migrez des domaines et il faut que Google abandonne rapidement une ancienne URL canonique. Un blogueur passé d'un sous-domaine GitHub Pages à un domaine personnalisé a constaté que les demandes manuelles dans Search Console n'avaient pas fait changer le choix de canonique de Google en 30 jours, ce qui explique en partie pourquoi certains développeurs scriptent des soumissions en masse.
- Vous devez exécuter le processus tous les jours plutôt qu'une seule fois.
- Vous voulez que les suppressions soient prises en compte rapidement. Les notifications
URL_DELETEDpermettent d'indiquer proprement à Google qu'une offre expirée ou un produit retiré n'existe plus.
Si aucun de ces cas ne correspond au vôtre, restez sur la voie gratuite. Mettre en place l'authentification de l'API pour un seul article de blog bloqué représente beaucoup d'ingénierie pour un problème que Search Console résout en deux clics.
Comment fonctionne l'API, en termes simples
Si vous relevez bien de l'approche plus lourde, la configuration se déroule en cinq étapes, et aucune ne demande de code avant la dernière.
- Créez un projet Google Cloud et activez-y l'API Indexing.
- Créez un compte de service et téléchargez sa clé privée, un fichier JSON.
- Ajoutez ce compte de service comme propriétaire (Owner) dans les autorisations utilisateur de votre propriété Search Console. Presque tout le monde se trompe à cette étape la première fois, et l'omettre fait renvoyer une erreur 403 à chaque appel de l'API.
- Attendez la propagation des autorisations, qui peut prendre de quelques minutes à quelques heures avant que les appels ne fonctionnent.
- Soumettez les URL avec un type de notification
URL_UPDATEDouURL_DELETED, authentifiées par un jeton OAuth obtenu en échange de votre clé privée.
Un script qui fait cela comporte généralement les mêmes quelques éléments : un module d'authentification qui charge la clé, une fonction qui soumet une URL et réessaie en cas d'échec, et une boucle principale qui lit les URL de votre sitemap et les soumet tout en restant sous le quota quotidien.
Chaque projet dispose d'un quota par défaut de 200 requêtes de publication par jour, mises à jour et suppressions comptées ensemble, plus 180 requêtes de métadonnées et 380 requêtes au total par minute. La limite quotidienne est réinitialisée à minuit, heure du Pacifique. Une mise à jour de la documentation d'octobre 2026, rapportée par Search Engine Journal, a supprimé le formulaire de demande d'approbation et les étapes pour demander un quota plus élevé, et Google n'a pas précisé si l'exigence d'approbation elle-même avait changé. Si vous comptez sur une augmentation de quota, consultez la page actuelle des quotas de la Google API Console plutôt que d'anciens guides.
Plusieurs outils commerciaux encapsulent cette même API dans un tableau de bord, pour que vous n'ayez pas à écrire le code d'authentification vous-même. Ils facturent généralement un abonnement mensuel ou un tarif par projet et annoncent des délais d'indexation moyens de quelques minutes, même si les résultats dépendent toujours de la file d'exploration de Google et de la qualité des pages.
Quand l'API n'est pas le bon outil
Passez votre chemin pour les contenus pérennes, pour les pages que Google a déjà explorées et rejetées, et pour tout site où un sitemap propre et un bon maillage interne permettent déjà de faire découvrir les nouvelles URL dans des délais raisonnables. Pour ces sites, les alternatives sont un sitemap soumis dans Search Console et une demande d'indexation manuelle (Request Indexing) pour la page occasionnelle. Un sitemap est la voie principale de découverte de vos URL en masse, alors que l'API est une voie rapide pour des pages précises.
Erreurs courantes à éviter
- Croire que soumettre revient à indexer. L'API met une exploration en file d'attente et ne promet aucun résultat : une page pauvre ou dupliquée ne sera donc pas indexée plus vite parce que vous l'avez soumise.
- Sauter l'étape de propriété dans Search Console. Le compte de service doit être propriétaire (Owner) de la propriété et non un simple utilisateur, faute de quoi chaque appel échoue avec une erreur 403.
- L'utiliser pour des contenus hors des types pris en charge en attendant la fiabilité que Google promet pour les offres d'emploi et les événements diffusés.
- Demander l'indexation de la même URL dans Search Console plusieurs fois en quelques heures.
- Traiter l'API comme un remplaçant du sitemap.
- Publier la clé JSON du compte de service dans un dépôt public. Traitez-la comme un mot de passe.
Si une page continue de ne pas s'indexer quoi que vous demandiez, la cause est souvent la qualité du contenu ou la duplication plutôt que la vitesse d'exploration. Un outil gratuit pour confirmer le classement de vos mots-clés avant de supposer que l'indexation est le goulot d'étranglement peut vous aider à vérifier.
Questions fréquentes
L'API Google Indexing garantit-elle que ma page sera indexée ?
Non. Elle informe Google qu'une URL a changé et demande une exploration prioritaire. Le robot de Google visite quand même la page et applique ses contrôles habituels de qualité et de pertinence avant de décider de l'indexer.
Puis-je utiliser l'API Indexing pour n'importe quel type de page ?
Officiellement, Google indique que l'API prend en charge les pages avec des données structurées JobPosting ou BroadcastEvent. Beaucoup de gens soumettent d'autres types d'URL et les voient acceptées, mais Google ne s'est pas engagé à ce que cela continue de fonctionner de façon fiable.
Quelle est la limite quotidienne de l'API Indexing ?
Par défaut, 200 requêtes de publication par jour et par projet, mises à jour et suppressions comprises, avec un plafond de 180 requêtes de métadonnées par minute. Le décompte quotidien est réinitialisé à minuit, heure du Pacifique.
Pourquoi l'API renvoie-t-elle une erreur 403 Forbidden ?
La cause habituelle est que le compte de service n'a pas été ajouté comme propriétaire (Owner) de la propriété dans Search Console. La propagation des autorisations peut aussi prendre de quelques minutes à quelques heures : un appel effectué juste après la configuration peut donc encore échouer.
L'API peut-elle forcer Google à réexplorer une page ?
Elle demande une exploration prioritaire, et c'est Google qui décide de la suite. Explorer une page n'oblige pas Google à l'indexer.
La demande d'indexation (Request Indexing) de Search Console est-elle identique à l'API Indexing ?
Les deux placent une URL dans une file d'exploration prioritaire. La demande d'indexation est gratuite, manuelle et intégrée à la console que vous utilisez déjà, tandis que l'API automatise le même type de demande sur de nombreuses URL.
En quoi l'API diffère-t-elle de la soumission d'un sitemap ?
Un sitemap liste vos URL pour que Google les explore selon son propre calendrier, et reste la voie principale pour l'essentiel de vos pages. L'API pousse des URL individuelles, par exemple nouvelles ou supprimées, dans une file plus rapide.
Pourquoi Google affiche-t-il « Discovered, currently not indexed » même après ma demande d'indexation ?
Google déprioritise généralement la page en raison du budget d'exploration, de la qualité de contenu perçue ou de sa ressemblance avec d'autres pages de votre site. Corriger la page elle-même est souvent plus efficace que de multiplier les soumissions.
Parlez à l'équipe
Traiter une URL bloquée dans Search Console prend environ cinq minutes. Traiter les problèmes d'indexation d'un site entier, semaine après semaine, c'est un mauvais usage d'appels d'API lancés à la main. Si vous voulez une vision claire des pages indexées, de celles qui sont bloquées et des raisons, parlez à l'équipe et obtenez un exemple de rapport construit autour de votre propre site.
Sources
À propos de l'auteur
SearchBlueprint a recherché, rédigé et noté cet article avec la chaîne de production de contenu que nos clients utilisent sur leurs propres sites. La note affichée dans la signature est celle que notre moteur de contenu a attribuée à cette page avant sa publication. Rien ici n'est relu à la main, et c'est tout l'intérêt : c'est le résultat du produit, publié là où chacun peut le vérifier.