En bref. Dans le JSON-LD de Schema.org, @id identifie un nœud afin que d’autres descriptions puissent faire référence à la même entité.

Définition : Dans le balisage Schema.org, @id est un mot-clé de JSON-LD, un format JSON qui exprime des données liées sous forme d’entités et de relations entre elles. Il identifie une entité afin que d’autres descriptions puissent y faire référence.

Le point de départ est la spécification JSON-LD 1.1 du W3C, une recommandation datée du 16 juillet 2020. Son modèle de données est un graphe : les nœuds représentent des ressources et les propriétés les relient. Une entité décrite dans le balisage est représentée par un nœud.

Points clés

La définition du mot-clé du W3C permet à @id d’identifier un nœud à l’aide d’un identifiant internationalisé de ressource (Internationalized Resource Identifier, IRI) ou d’un identifiant de nœud anonyme (blank node), une étiquette dont la portée se limite au document.
Le modèle de données de Schema.org définit des types et des propriétés et s’appuie sur des formats sous-jacents, dont JSON-LD.
Schema.org définit url comme l’URL de l’élément.
Schema.org définit sameAs comme l’URL d’une page de référence qui indique sans ambiguïté l’identité de l’élément, avec Wikipedia et Wikidata parmi ses exemples.

Comment @id relie-t-il les descriptions ?

La section sur les identifiants de nœuds du W3C illustre l’identification avec Markus Lanthaler. Cet extrait JSON complet conserve l’identifiant et la correspondance du nom de cet exemple, sans les champs omis :

{
  "@context": {
    "name": "http://schema.org/name"
  },
  "@id": "http://me.markus-lanthaler.com/",
  "name": "Markus Lanthaler"
}

Ici, @context associe le nom court name à une propriété Schema.org. La valeur de @id identifie le nœud décrit par l’objet. Un objet qui contient uniquement @id est une référence à un nœud. Utilisé comme valeur d’une propriété, {"@id": "http://me.markus-lanthaler.com/"} fait référence à ce nœud sans répéter son nom.

La même spécification permet de répartir les propriétés d’un nœud entre plusieurs objets d’un document. Le traitement fusionne ces propriétés dans le nœud résultant. C’est le rôle pratique d’un identifiant commun lorsque les descriptions figurent à différents endroits des données.

Quelles différences entre @id, url et sameAs ?

@id appartient à la syntaxe JSON-LD. La définition de url de Schema.org décrit une propriété dont la valeur est l’URL de l’élément. Dans l’exemple ci-dessus, l’identification passe par @id ; ajouter une propriété url apporterait une information supplémentaire sur l’élément.

La définition de sameAs décrit une page de référence qui permet d’établir l’identité. Elle donne comme exemples la page Wikipedia, l’entrée Wikidata ou le site officiel d’un élément. La propriété exprime une relation avec cette page de référence ; @id fournit l’identifiant du nœud décrit.

Ces rôles permettent de distinguer l’identifiant de l’entité des pages web fournies à son sujet. Selon la définition de Schema.org, un lien sameAs nécessite une page qui indique l’identité sans ambiguïté.

Comment fonctionnent les identifiants relatifs et les nœuds anonymes ?

Un IRI est un identifiant composé d’un schéma et d’un chemin, auxquels peuvent s’ajouter une chaîne de requête et un fragment. La section sur l’IRI de base du W3C explique que les identifiants relatifs sont résolus par rapport à une adresse de base. Son exemple utilise un @id vide, qui se résout en l’adresse de base du document et change lorsque le document est déplacé. Le mot-clé @base permet de définir explicitement cette base.

Pour les identifiants réutilisés sur plusieurs pages, un IRI absolu évite de dépendre de l’adresse de base de chaque page. Il importe de vérifier la valeur résolue lorsque le balisage est copié d’une page à l’autre.

Un nœud anonyme représente une ressource sans IRI. Son identifiant commence par _: et sa portée se limite au document. La même spécification explique que les processeurs peuvent réattribuer les identifiants des nœuds anonymes et recommande un IRI déréférençable, qui renvoie une représentation lorsqu’on y accède, lorsqu’un nœud doit pouvoir faire l’objet de références depuis d’autres documents.

Termes associés

Questions fréquentes

Chaque objet doit-il avoir un @id ?

Les recommandations sur les nœuds anonymes du W3C autorisent les nœuds sans identifiant explicite. Un identifiant devient utile lorsqu’une autre description doit faire référence à ce nœud.

Un @id peut-il contenir un fragment comme #me ?

Oui. La même spécification autorise les fragments dans les IRI et utilise https://greggkellogg.net/foaf#me pour identifier une personne dans ses exemples de mise en relation.

La casse de @id a-t-elle une importance ?

Oui. La spécification précise que les clés, mots-clés et valeurs JSON-LD sont sensibles à la casse. Utilisez la forme en minuscules @id.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Schema.org @id