En bref. tdmrep.json est un fichier placé à l’adresse /.well-known/tdmrep.json qui associe les chemins des ressources web à des valeurs de réservation des droits de fouille de textes et de données et à des liens facultatifs vers des politiques.

Définition : tdmrep.json est le fichier JSON du TDM Reservation Protocol qui permet à un titulaire de droits de déclarer, à l’échelle d’un site, s’il réserve les droits de fouille de textes et de données (text and data mining, TDM) sur des ressources web. Placé à l’adresse /.well-known/tdmrep.json, il associe des motifs de chemin d’URL à des valeurs de réservation et à des liens facultatifs vers des politiques de licence.

La fouille de textes et de données désigne l’analyse automatisée de textes et de données numériques pour produire des informations, telles que des régularités ou des corrélations. Le rapport TDM Reservation Protocol, daté du 10 mai 2024, spécifie le mécanisme du fichier. Il est publié par le Text and Data Mining Reservation Protocol Community Group ; il a le statut de rapport de groupe communautaire (Community Group) et se situe hors du parcours de normalisation du W3C (W3C Standards Track).

Points clés

La spécification du fichier exige un tableau JSON de règles contenant chacune location et tdm-reservation ; tdm-policy est facultatif.
Le vocabulaire sémantique TDMRep définit la valeur de réservation 1 pour les droits réservés et 0 pour les droits non réservés.
La RFC 8615 place les emplacements bien connus (well-known) au sommet de la hiérarchie des chemins d’URL : le fichier doit donc se trouver sous /.well-known/, à la racine de l’origine.

Que contient le fichier ?

L’exemple applicable à l’ensemble du site du rapport réserve les droits TDM pour tous les fichiers d’un serveur web avec le JSON suivant :

[
  {
    "location": "/",
    "tdm-reservation": 1
  }
]

Le tableau englobant reste obligatoire même lorsqu’il ne contient qu’une seule règle. Ici, location fournit le motif de chemin et tdm-reservation indique le choix du titulaire de droits. L’exemple ne comporte pas de politique de licence.

Une politique TDM décrit les types de licences de fouille proposés par un titulaire de droits. Une règle peut ajouter tdm-policy avec une URL pointant vers cette politique distincte. Le même rapport illustre différents choix pour /directory-a/, /directory-b/html/ et /directory-b/images/*.jpg, notamment des droits réservés avec un lien vers une politique et des droits non réservés pour les images JPEG.

Comment les règles de chemin s’appliquent-elles ?

Selon les règles de correspondance du rapport, un agent TDM, c’est-à-dire un logiciel qui accède à des ressources pour en effectuer la fouille, compare l’URL d’une ressource aux chemins déduits de chaque motif. La correspondance devrait être sensible à la casse. Le rapport impose de retenir la correspondance la plus spécifique et précise que celle-ci est la première dans la séquence.

Les caractères spéciaux pris en charge sont *, qui correspond à zéro ou plusieurs occurrences de n’importe quel caractère, et $, qui marque la fin d’un motif. En l’absence de règle correspondante, la valeur de réservation pour cette URL est unset. Toute valeur de réservation autre que 0 ou 1 constitue une erreur de protocole et produit également unset.

Comment le fichier s’articule-t-il avec les signaux propres à chaque page ?

Les règles de priorité de traitement du rapport imposent à un agent TDM de consulter le fichier du serveur avant de commencer l’extraction du contenu du serveur (scraping). Les en-têtes de réponse HTTP peuvent ensuite remplacer les valeurs obtenues à partir du fichier. Les métadonnées intégrées au HTML remplacent les valeurs antérieures ; les métadonnées intégrées aux fichiers EPUB ou PDF remplacent elles aussi les valeurs précédentes.

À chaque étape, l’absence de propriétés de réservation ou de politique laisse les valeurs courantes en place. Le rapport recommande aux titulaires de droits d’utiliser une seule technique de signalement. Lorsque plusieurs techniques coexistent, la seule consultation de tdmrep.json donne une vue incomplète des valeurs effectives du protocole pour une ressource.

Termes associés

Questions fréquentes

Comment vérifier que le fichier est correctement servi ?

Demandez /.well-known/tdmrep.json et analysez la réponse comme du JSON. Les exigences du rapport pour le serveur autorisent une réponse de succès contenant la représentation ou des redirections qui y mènent ; vérifiez que chaque règle contient les propriétés obligatoires.

Faut-il publier un lien vers une politique de licence ?

Le rapport rend tdm-policy facultatif. Son exemple applicable à l’ensemble du site utilise uniquement location et tdm-reservation : une réservation peut donc être déclarée sans lien vers une politique.

Sources

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