Collecter l'ID, l'URL et le nom de votre contenu

Toutes les entités de votre catalogue doivent inclure les propriétés suivantes:

Exemple de @id, url et name :

"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",

Identifiant

Un identifiant (@id) doit respecter les conditions suivantes:

  • Unique au niveau mondial dans l'ensemble de votre catalogue
    • Par exemple, n'utilisez pas le même @id pour un TVSeries et un TVSeason.
  • Statique
    • Vous ne pourrez plus modifier @id par la suite.
  • Au format URI (Uniform Resource Identifier)
    • Si l'identifiant local (ID) de votre contenu n'est pas au format URI, ajoutez votre domaine à l'ID pour répondre à cette exigence. Par exemple, si l'ID de votre contenu est 1234abc et que votre domaine est https://example.com, @id peut être https://example.com/1234abc.
    • @id ne doit pas nécessairement être une URL fonctionnelle. Il doit simplement être au format URI.
    • Le domaine utilisé dans @id (par exemple, https://example.com) doit appartenir à votre organisation.

Étant donné que l'url d'une entité répond à toutes les exigences en tant qu'identifiant (c'est-à-dire qu'il est globalement unique, statique et au format d'un URI), nous vous recommandons d'utiliser l'url d'une entité comme @id.

URL canonique

Une URL canonique (url) permet à Google de faire le rapprochement entre le contenu de votre catalogue et celui de ses bases de données.

"Une URL canonique est l'URL de la page considérée par Google comme la plus représentative de l'ensemble de pages en double sur votre site. Par exemple, si vous avez plusieurs URL pour une même page (par exemple, example.com?dress=1234 et example.com/dresses/1234), Google en choisit une comme URL canonique." (Source: Consolider les URL en double)

Voici les conditions requises pour l'URL canonique:

  • url doit être unique.
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • (Actions d'écoute uniquement) url doit rediriger vers une page de description de contenu qui n'est pas bloquée par un mur payant.

Collecter l'ID, l'URL et le nom

Procédez comme suit :

  1. Récupérez les noms des contenus de votre catalogue.
  2. Identifiez les URL canoniques du contenu. (Nous vous recommandons d'utiliser le url du contenu comme @id.)