Utiliser l’API d’indexation : notifier l’ajout ou la suppression de pages
Apprenez à utiliser l'API d'indexation pour signaler à Google la mise à jour ou la suppression d'une URL, et à grouper jusqu'à 100 requêtes.
L’API d’indexation signale directement à Google qu’une page doit être mise à jour dans son index ou en être retirée. Plutôt que d’attendre le prochain passage du robot, vous indiquez l’emplacement exact de la page concernée.
Pour le SEO, l’intérêt est la réactivité sur les contenus sensibles au temps. L’API ne peut être utilisée que pour des pages contenant le balisage JobPosting ou BroadcastEvent dans un VideoObject : offres d’emploi et événements en direct, ces pages éphémères à notifier à Google, où chaque heure compte. Bien utilisée, elle accélère la prise en compte de vos ajouts et de vos retraits.
L’API d’indexation séduit par sa réactivité, mais je dois sans cesse rappeler son périmètre strict : elle ne fonctionne que pour les pages portant un balisage JobPosting ou BroadcastEvent. La tenter sur un article de blog ou une fiche produit ne sert à rien et brouille votre dispositif. Sur ces contenus éphémères où chaque heure compte, en revanche, c’est elle qui accélère vraiment la prise en compte de vos ajouts et retraits.
Les deux champs obligatoires
Toutes les méthodes de notification reposent sur le même corps de requête, avec deux champs obligatoires. Le champ url désigne la page concernée, et le champ type précise l’action attendue. Le tableau ci-dessous les détaille.
| Champ | Statut | Rôle |
|---|---|---|
url |
Obligatoire |
URL complète de l’élément à mettre à jour ou à supprimer |
type |
Obligatoire |
Type de notification : URL_UPDATED ou URL_DELETED |
Notifier une mise à jour ou un ajout
Pour informer Google qu’une nouvelle URL doit être explorée, ou que le contenu d’une URL connue a changé, envoyez une requête HTTP POST au point de terminaison publish, avec l’URL et le type URL_UPDATED. Tous les appels doivent utiliser application/json comme en-tête Content-Type.
Une réponse HTTP 200 signifie que Google tentera de réexplorer cette URL prochainement. Si le contenu change à nouveau plus tard, renvoyez une nouvelle notification de mise à jour.
POST https://indexing.googleapis.com/v3/urlNotifications:publish
Content-Type: application/json
{
"url": "https://monsite.fr/jobs/42",
"type": "URL_UPDATED"
}Notifier une suppression
Pour demander le retrait d’une page de l’index, envoyez une requête POST au même point de terminaison, avec le type URL_DELETED. Une condition stricte s’applique d’abord : avant la demande, l’URL doit renvoyer un code 404 ou 410, ou la page doit porter la balise meta robots noindex.
Une réponse HTTP 200 indique que Google tentera de supprimer l’URL de son index. Si vous n’obtenez pas de 200, consultez la liste des codes d’erreur HTTP propres à l’API pour diagnostiquer la cause.
Grouper les requêtes par lot
Pour réduire le nombre de connexions HTTP, vous pouvez combiner jusqu’à 100 appels dans une seule requête par lot, envoyée au point de terminaison batch. Chaque partie est une requête HTTP complète et ne peut pas dépasser 1 Mo. Le quota est comptabilisé au niveau de l’URL : 10 requêtes groupées comptent pour 10. Les bibliothèques clientes Google facilitent l’envoi de ces lots, une fois l’accès en place après avoir su créer un compte de service.
Ne notifiez une suppression que si la page renvoie déjà un code 404 ou 410, ou contient la balise meta robots noindex. Demander le retrait d’une URL encore accessible et indexable n’aura pas l’effet attendu. Et n’essayez jamais de contourner les limites d’envoi, par exemple avec plusieurs comptes : c’est contraire aux consignes de Google.
À faire
- utiliser l’en-tête Content-Type application/json
- renseigner url et type
- vérifier le code 404/410 ou le noindex avant une suppression
- grouper les appels volumineux par lot
À éviter
- utiliser un type autre que URL_UPDATED ou URL_DELETED
- demander la suppression d’une page encore en ligne
- dépasser 100 requêtes par lot ou 1 Mo par partie
- multiplier les comptes pour contourner le quota
Points clés à retenir
- envoyez un POST avec url et type dans le corps
- utilisez URL_UPDATED pour un ajout ou une mise à jour
- utilisez URL_DELETED après un 404, 410 ou noindex
- une réponse HTTP 200 confirme la prise en compte
- groupez jusqu'à 100 requêtes par lot pour gagner en efficacité
Deux actions, un même point de terminaison publish.
Quiz : testez vos connaissances
Quiz : testez vos connaissances
-
Quels sont les deux champs obligatoires du corps de requête de notification ?
- Le champ url et le champ notifyTime
- Le champ url et le champ type
- Le champ type et le champ Content-Type
Toutes les méthodes de notification reposent sur deux champs obligatoires :
urldésigne la page concernée ettypeprécise l’action attendue. -
Quelle condition l'URL doit-elle remplir avant une demande de suppression ?
- Être encore accessible et renvoyer un code 200
- Avoir été supprimée du sitemap au préalable
- Renvoyer un code 404 ou 410, ou porter la balise meta robots noindex
Avant la demande, l’URL doit renvoyer un code 404 ou 410, ou la page doit porter la balise
meta robots noindex. Demander le retrait d’une URL encore accessible est à éviter. -
Quel en-tête Content-Type tous les appels doivent-ils utiliser ?
- L'en-tête application/xml
- L'en-tête application/json
- L'en-tête text/html
Tous les appels doivent utiliser
application/jsoncomme en-tête Content-Type, que ce soit pour une mise à jour ou une suppression.
À propos de l'auteur
Besoin d'un accompagnement SEO ?
Vous souhaitez automatiser la notification de vos pages à Google sans fausse manœuvre ?