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 pasurlsur les entitésBroadcastEvent,SportsEventou de programmation de chaînes (TelevisionChanneletCableOrSatelliteService).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
@idpour unTVSerieset unTVSeason.
- Par exemple, n'utilisez pas le même
- Statique
- Vous ne pourrez pas modifier
@idpar la suite.
- Vous ne pourrez pas modifier
- 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,
@idpeut être https://example.com/1234abc. @idn'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.
- 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,
É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 :
urldoit être unique.urldoit contenir une URL canonique fonctionnelle que Google peut explorer.- (Actions d'écoute uniquement)
urldoit 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
urlsurBroadcastEvent. Pour les diffusions de séries TV et de films, indiquezurlsur l'entitéMovie,TVSeriesouTVEpisodesous-jacente. - (Sports) N'incluez pas
urlsur les entitésSportsEvent. Fournissez des liens de lecture à l'aide deSportsEvent.potentialAction. - (Télévision en direct et sports) Assurez-vous que
BroadcastEvent.@idest distinct de@idde l'entitéMovie,TVSeries,TVEpisodeouSportsEventréférencée.
Collecter l'ID, l'URL et le nom
Procédez comme suit :
- Récupérez les noms des contenus de votre catalogue.
- Identifiez les URL canoniques du contenu. (Nous vous recommandons d'utiliser le
urldu contenu comme@id.)