Consulter l’état d’une notification d’URL (API d’indexation)
Vérifiez avec la méthode getMetadata si Google a bien reçu vos notifications d'URL et quand, pour fiabiliser votre suivi d'indexation.
La méthode getMetadata de l’API d’indexation sert à vérifier que Google a bien enregistré les notifications d’URL que vous lui avez envoyées, et à quelle date. Elle ne déclenche aucune action d’exploration : elle se contente de lire les métadonnées de la dernière notification reçue pour une URL donnée, une fois le compte de service créé. C’est l’outil de contrôle qui complète l’envoi de notifications.
Pour le SEO, ce suivi est précieux quand vous pilotez l’indexation de pages sensibles au temps, comme les offres d’emploi ou les événements diffusés en direct. Confirmer la bonne réception d’une notification vous permet de distinguer un problème d’envoi d’un simple délai de traitement côté Google, et donc de diagnostiquer plus vite.
Cette méthode en lecture seule, je la considère comme le contrôle qualité indispensable de l’API d’indexation, et trop de monde l’ignore. Elle ne déclenche aucune exploration, elle confirme simplement que Google a bien reçu votre notification et quand. Sur des pages sensibles au temps comme un événement en direct, ce simple accusé de réception vous évite de croire qu’une URL est prise en compte alors qu’elle ne l’est pas.
Une méthode en lecture seule
La méthode getMetadata extrait les métadonnées relatives à un document web. Point important : elle ne peut être utilisée que pour interroger des URL déjà apparues dans des notifications d’API d’indexation ayant abouti. Si une URL n’a jamais été notifiée avec succès, vous n’obtiendrez pas de métadonnées pour celle-ci.
La réponse inclut la dernière ressource UrlNotification reçue via l’API pour cette URL. Vous savez ainsi quel type de notification (mise à jour ou suppression) a été enregistré en dernier, et à quel horodatage.
La requête HTTP et ses paramètres
L’appel se fait via une requête GET sur le point de terminaison metadata, en complément des appels qui servent à notifier une mise à jour ou une suppression. L’URL à interroger se passe en paramètre de requête, et le corps de la requête doit rester vide. Pensez à encoder l’URL interrogée.
GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=ENCODED_URLLa réponse renvoyée par l'API
Si la requête aboutit, le corps de la réponse contient une instance de UrlNotificationMetadata ; en cas d’échec, reportez-vous à la liste des codes d’erreur. Cet objet récapitule les dernières notifications reçues avec succès pour l’URL. Le tableau ci-dessous détaille ses champs.
| Champ | Type | Rôle |
|---|---|---|
url |
string |
URL à laquelle ces métadonnées font référence |
latestUpdate |
object (UrlNotification) |
Dernière notification reçue avec le type URL_UPDATED |
latestRemove |
object (UrlNotification) |
Dernière notification reçue avec le type URL_REMOVED |
getMetadata interroge uniquement l’historique des notifications. Si vous demandez l’état d’une URL qui n’a jamais fait l’objet d’une notification ayant abouti, l’appel n’aura pas de métadonnées à vous retourner. Vérifiez aussi que la requête est bien authentifiée avec le scope OAuth https://www.googleapis.com/auth/indexing.
À faire
- encoder correctement l’URL passée en paramètre
- laisser le corps de la requête vide
- utiliser le scope OAuth indexing
- lire le champ qui vous intéresse (latestUpdate ou latestRemove)
À éviter
- utiliser getMetadata pour vérifier si une page est indexée
- interroger une URL jamais notifiée
- confondre cette lecture avec une demande d’exploration
- oublier l’authentification
Points clés à retenir
- vérifiez la bonne réception d'une notification, pas l'indexation finale
- interrogez uniquement des URL déjà notifiées avec succès
- envoyez une requête GET avec l'URL encodée en paramètre
- lisez latestUpdate et latestRemove dans la réponse
- authentifiez chaque appel avec le scope OAuth indexing
getMetadata est l’outil de contrôle de vos notifications d’URL.
Quiz : testez vos connaissances
Quiz : testez vos connaissances
-
La méthode getMetadata indique-t-elle si votre page est indexée ?
- Non, elle confirme seulement la date et le type de la dernière notification reçue
- Oui, mais uniquement pour les pages avec un balisage JobPosting
- Oui, elle renvoie l'état d'indexation réel de la page
La méthode
getMetadatane déclenche aucune exploration. Elle confirme seulement la date et le type de la dernière notification reçue par Google, pas l’état d’indexation réel. -
Quelle méthode HTTP utilise l'appel à getMetadata ?
- Une requête POST avec l'URL dans le corps de la requête
- Une requête GET avec un corps de requête vide
- Une requête DELETE sur le point de terminaison metadata
L’appel se fait via une requête GET sur le point de terminaison metadata. L’URL à interroger se passe en paramètre de requête et le corps doit rester vide.
-
Pourquoi une URL peut-elle ne renvoyer aucune métadonnée ?
- Parce que la page n'est pas encore présente dans le sitemap
- Parce que le quota quotidien de lecture est épuisé
- Parce qu'elle n'est jamais apparue dans une notification ayant abouti
La méthode ne fonctionne que pour des URL déjà apparues dans une notification ayant abouti. Une URL jamais notifiée avec succès ne renvoie aucune métadonnée.
À propos de l'auteur
Besoin d'un accompagnement SEO ?
Vous voulez fiabiliser le pilotage de votre indexation via l'API ?