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

Les entités de contenu de votre catalogue nécessitent généralement les propriétés suivantes :

  • @id : identifiant global de l'entité.
  • url : URL canonique du contenu. N'utilisez pas url sur les entités BroadcastEvent, SportsEvent ou de programmation de chaînes (TelevisionChannel et CableOrSatelliteService).
  • name : nom du contenu.

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 répondre aux exigences suivantes :

  • Unique au niveau mondial dans votre catalogue
    • Par exemple, n'utilisez pas le même @id pour un TVSeries et un TVSeason.
  • Statique
    • Vous ne pourrez pas modifier @id par la suite.
  • Sous la forme d'un URI (Uniform Resource Identifier)
    • Si l'identifiant local de votre contenu n'est pas au format URI, ajoutez votre domaine avant l'identifiant pour répondre à cette exigence. Par exemple, si l'identifiant de votre contenu est 1234abc et que votre domaine est https://example.com, @id peut être https://example.com/1234abc.
    • @id n'a pas besoin d'ê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 le url d'une entité répond à toutes les exigences d'un identifiant (c'est-à-dire qu'il est unique au monde, statique et sous la forme d'un URI), nous vous recommandons d'utiliser le url d'une entité comme @id.

URL canonique

Une URL canonique (url) aide Google à faire correspondre précisément le contenu de votre catalogue avec 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 dupliquées sur votre site. Par exemple, si vous avez plusieurs URL pour une même page (example.com?dress=1234 et example.com/dresses/1234, par exemple), Google en choisit une comme URL canonique." (Source : Consolider les URL en double)

Voici les exigences concernant l'URL canonique :

  • url doit être unique.
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
  • (Actions d'écoute uniquement) url doit pointer vers une page de description du contenu qui n'est pas bloquée par un paywall.
  • (Télévision en direct) N'incluez pas d'entités url sur BroadcastEvent. Pour les diffusions de séries TV et de films, indiquez url sur l'entité Movie, TVSeries ou TVEpisode sous-jacente.
  • (Sports) N'incluez pas url sur les entités SportsEvent. Fournissez des liens de lecture à l'aide de SportsEvent.potentialAction.
  • (Télévision en direct et sports) Assurez-vous que BroadcastEvent.@id est distinct de @id de l'entité Movie, TVSeries, TVEpisode ou SportsEvent référencée.

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.)