Ce que fait l'API d'indexation
L'API envoie à Google une notification URL_UPDATED (page nouvelle ou modifiée) ou URL_DELETED (page supprimée). Google peut alors explorer la page plus vite qu'en attendant le passage normal de son robot.
JobPosting) ou des vidéos en direct (BroadcastEvent dans un VideoObject). Google précise aussi que les envois font l'objet d'une détection de spam et que l'accès peut être retiré en cas d'abus.La configurer, en résumé
- Dans Google Cloud Console, créez un projet.
- Activez l'API Web Search Indexing API pour ce projet.
- Créez un compte de service, puis une clé JSON pour ce compte, et téléchargez-la.
- Dans Search Console, Paramètres › Utilisateurs et autorisations, ajoutez l'adresse e-mail du compte de service en tant que Propriétaire.
- Dans le plugin Instant Indexing & Check, collez la clé JSON : le plugin vérifie la connexion et vous dit précisément quelle étape bloque, le cas échéant.
Le quota de 200 demandes par jour (erreur 429)
Par défaut, chaque projet Google Cloud a droit à 200 demandes de publication par jour. Au-delà, Google répond par une erreur 429 :
Quota exceeded for quota metric 'Publish requests' and limit
'Publish requests per day' of service 'indexing.googleapis.com'Ce n'est pas un problème de votre site : le compteur du jour est simplement épuisé. Il repart à minuit, heure du Pacifique, soit vers 9 h à Paris. Vos options :
- Attendre la remise à zéro et envoyer en priorité vos pages les plus importantes.
- Demander une augmentation dans Google Cloud Console (API et services › Quotas). C'est Google qui décide : cela peut prendre plusieurs jours et c'est souvent refusé.
- Utiliser un autre canal : le Force Index du plugin n'utilise pas votre quota Google.
Depuis la version 2.1.6, le plugin explique cette erreur clairement, arrête l'envoi des URLs restantes (elles gardent leur statut) et reprend automatiquement après une limite par minute.
Les autres erreurs fréquentes
| Message | Cause | Solution |
|---|---|---|
403 Permission denied. Failed to verify the URL ownership | Le compte de service n'est pas propriétaire de la propriété Search Console. | Ajoutez-le en Propriétaire (pas « Complet ») dans Search Console. |
Web Search Indexing API has not been used in project … or it is disabled | L'API n'est pas activée dans le projet. | Activez « Web Search Indexing API », attendez quelques minutes. |
invalid_grant | Clé JSON supprimée, incomplète ou mal copiée. | Créez une nouvelle clé et recollez le fichier entier. |
Est-ce efficace pour des articles ?
Pour des pages qui ne sont ni des offres d'emploi ni des vidéos en direct, l'API reste une simple notification que Google peut ignorer. En pratique, elle accélère l'exploration de certaines pages, mais une bonne partie des articles envoyés ne sont pas indexés pour autant, surtout sur les sites récents. C'est utile en complément, rarement suffisant seul.
Les alternatives
- Le sitemap et le maillage interne : la base, à soigner avant tout le reste.
- « Demander une indexation » dans Search Console : fiable, mais quelques URLs par jour, à la main.
- Un service d'indexation comme le Force Index du plugin : pas de clé à configurer, pas de quota Google, payé à l'URL (1 crédit).
Questions fréquentes
Utiliser l'API pour des articles est-il risqué ?
Google la réserve officiellement aux offres d'emploi et aux vidéos en direct et indique pouvoir retirer l'accès en cas d'abus. Pour signaler normalement vos propres nouvelles pages, le risque principal est surtout que Google ignore la demande.
Peut-on contourner le quota avec plusieurs projets ?
Techniquement, chaque projet a son quota. Mais multiplier les projets pour envoyer massivement ressemble à de l'abus aux yeux de Google : mieux vaut prioriser vos pages ou utiliser un autre canal.
L'API vérifie-t-elle si une page est indexée ?
Non. Elle ne fait que notifier Google. Pour vérifier l'indexation, il faut l'inspection d'URL de Search Console (2 000 par jour et par propriété) ou le Premium Check du plugin.