Notifier une URL mise à jour ou supprimée (méthode publish)
Maîtrisez la méthode publish de l'API d'indexation pour signaler à Google une URL modifiée ou retirée et accélérer sa réexploration.
La méthode publish est le point d’entrée de l’API d’indexation pour signaler qu’une URL a été mise à jour ou supprimée. C’est elle que vous appelez pour demander à Google de réexplorer une page modifiée ou de retirer de son index une page que vous avez supprimée. Son rôle est simple : transmettre une notification de cycle de vie d’URL à Google.
Pour le SEO, cette méthode est centrale sur les contenus sensibles au temps. Plutôt que d’attendre que Googlebot repasse de lui-même, vous déclenchez la réexploration au bon moment. Cela accélère la fraîcheur de vos offres d’emploi et de vos diffusions en direct dans les résultats de recherche, et limite le risque qu’une page expirée reste visible.
Sur le terrain, je vois trop d’équipes utiliser la méthode publish comme un bouton magique pour faire indexer n’importe quelle page. Réservez-la à ce pour quoi elle est prévue, les contenus à cycle de vie court comme les offres d’emploi et les diffusions en direct. Et n’oubliez jamais de notifier la suppression d’une URL avec le bon type d’événement, c’est la moitié du travail que tout le monde néglige.
La requête HTTP
L’appel se fait par une requête POST sur le point de terminaison publish de l’API. L’URL suit la syntaxe d’annotation HTTP standard des API Google et chaque appel s’authentifie avec le compte préparé en suivant comment créer un compte de service. Voici la requête de base à adresser au serveur.
POST https://indexing.googleapis.com/v3/urlNotifications:publishLe corps de la requête
Le corps de la requête contient une instance de la ressource UrlNotification. Vous y précisez l’URL concernée et le type d’événement à notifier. Le type prend l’une des valeurs prévues par l’API : URL_UPDATED pour une mise à jour, URL_DELETED pour une suppression. Le tableau ci-dessous détaille les champs à renseigner.
| Champ | Type | Rôle |
|---|---|---|
url |
string |
URL concernée par la notification, qui doit vous appartenir |
type |
enum (UrlNotificationType) |
Événement à notifier (URL_UPDATED ou URL_DELETED) |
notifyTime |
string (Timestamp) |
Ne pas renseigner : ce champ est ignoré au moment de la requête |
{
"url": "https://www.exemple.com/offres/123",
"type": "URL_UPDATED"
}La réponse renvoyée
Si la requête aboutit, le corps de la réponse contient un objet PublishUrlNotificationResponse. Celui-ci renvoie un champ urlNotificationMetadata qui décrit les événements de notification déjà reçus pour cette URL. Vous obtenez ainsi une confirmation de prise en compte et un récapitulatif de l’historique récent, que vous pouvez ensuite consulter pour vérifier l’état d’une notification.
{
"urlNotificationMetadata": {
"object": "UrlNotificationMetadata"
}
}L'autorisation requise
Chaque appel à publish doit être authentifié. La méthode requiert le champ d’application OAuth dédié à l’API d’indexation. Sans ce scope, la requête sera rejetée. Le tableau ci-dessous récapitule l’autorisation à fournir.
| Élément | Valeur |
|---|---|
Méthode HTTP |
POST |
Point de terminaison |
urlNotifications:publish |
Corps |
Instance UrlNotification |
Scope OAuth |
https://www.googleapis.com/auth/indexing |
L’URL passée dans la notification doit appartenir à la propriété que vous avez validée. Pour une notification URL_UPDATED, la page doit aussi rester explorable par Google au moment de l’appel. Ne renseignez jamais le champ notifyTime : il est ignoré et défini automatiquement par l’API.
À faire
- envoyer une requête POST sur urlNotifications:publish
- fournir un corps UrlNotification complet
- choisir le bon type (URL_UPDATED ou URL_DELETED)
- authentifier avec le scope indexing
À éviter
- renseigner manuellement notifyTime
- notifier une URL qui ne vous appartient pas
- signaler en URL_UPDATED une page bloquée à l’exploration
- oublier le jeton d’accès
Points clés à retenir
- envoyez une requête POST sur le point de terminaison publish
- placez une instance UrlNotification dans le corps
- choisissez le type URL_UPDATED ou URL_DELETED
- laissez le champ notifyTime vide
- authentifiez chaque appel avec le scope OAuth indexing
La méthode publish signale à Google une URL mise à jour ou supprimée.
Quiz : testez vos connaissances
Quiz : testez vos connaissances
-
Quelle méthode HTTP utilise l'appel à publish ?
- Une requête GET sur le point de terminaison publish
- Une requête PUT sur le point de terminaison metadata
- Une requête POST sur le point de terminaison publish
L’appel se fait par une requête POST sur le point de terminaison
urlNotifications:publish, avec une instance UrlNotification dans le corps de la requête. -
Quelle valeur de type utilisez-vous pour signaler la suppression d'une page ?
- La valeur URL_REMOVED
- La valeur URL_DELETED
- La valeur URL_UPDATED
Le corps de la requête prend la valeur
URL_DELETEDpour une suppression etURL_UPDATEDpour une mise à jour. -
Quelle condition l'URL passée dans une notification doit-elle remplir ?
- Avoir déjà été indexée au moins une fois par Google
- Appartenir à la propriété que vous avez validée
- Figurer obligatoirement dans votre fichier sitemap
L’URL passée dans la notification doit appartenir à la propriété que vous avez validée. Pour une notification
URL_UPDATED, la page doit aussi rester explorable.
À propos de l'auteur
Besoin d'un accompagnement SEO ?
Vous souhaitez automatiser le signalement de vos pages à Google sans erreur ?