Cette page a été traduite par l'API Cloud Translation.

Propriétés de balisage de contenu des émissions télévisées

Cette section fournit des informations détaillées sur les propriétés de balisage de contenu pour les types d'entités TVSeries, TVEpisode et TVSeason.

Vous n'êtes pas obligé de fournir TVSeason en tant qu'entité complète. Pour en savoir plus, consultez la section Relations entre les séries TV, saisons et épisodes TV.

Tableau des spécifications

TVSeries

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : toujours défini sur `["http://schema.org", {"@language": "xx"}]` Où ?" xx pouces représente la langue des chaînes du flux. La balise @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres est l'anglais.
`@type`	Texte	Obligatoire : toujours défini sur `TVSeries`.
`@id`	URL	Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit remplir les conditions suivantes: Unique au niveau mondial dans votre catalogue L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel. Sous la forme d'un identifiant de ressource unifié (URI) Le domaine utilisé pour la valeur @id doit appartenir à votre organisation. Étant donné que le `url` d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut `url` d'une entité en tant que `@id`. Pour en savoir plus, consultez la section Identifiant.
`url`	URL	Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données. `url` doit respecter les exigences suivantes : `url` doit être unique `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour le lien profond de la lecture, consultez plutôt la propriété `urlTemplate` de l'objet cible.
`name`	Texte	Obligatoire : nom de l'émission. Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues. Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? : identifiant EIDR (Entertainment Identifier Registry) représentant au niveau le plus général/abstrait d'une œuvre de film ou de télévision. Exemple : titre EIDR pour la série "Game of Thrones" est "10.5240/C1B5-3BA1-8991-A571-8472-W".
`potentialAction`	WatchAction	Obligatoire, le cas échéant : un objet de balisage Action qui fournit les détails de l'action. Si le contenu est disponible pour la vidéo à la demande (VoD), cette propriété est obligatoire. L'objet de balisage Action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. À la place, l'entité `BroadcastService` associée fournit le lien profond du canal. Un `TVSeries` peut être disponible à la fois sur VoD et LiveTV. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
`sameAs`	URL	Fortement recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier l'émission. par exemple, la page Wikipédia de l'émission. Elle doit être distincte de la propriété `url`.
`inLanguage`	Texte	Langue d'origine de la série au format BCP 47.
`genre`	Texte	Liste numérotée de tous les genres pertinents. Par exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés permettant de décrire le contenu.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement recommandé Pourquoi ? - Un `PublicationEvent` permet d'indiquer la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme sa date de sortie en salle. Vous pouvez également utiliser `FeaturedEvent` pour indiquer que votre service commercialise ce contenu en tant que contenu original, sélectionné, spécial, etc. `ExclusiveEvent` indique que votre service dispose de droits de distribution exclusifs, et inclut où et quand. Consultez la section Exemples pour obtenir des détails et des exemples.
`releasedEvent.@type`	Texte	Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes : `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Pays	Obligatoire : régions associées à cet événement. Pour une `PublicationEvent`, il s'agit de la région dans laquelle le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région où le contenu est présenté ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer partout dans le monde, définissez la valeur sur `EARTH`.
`releasedEvent.startDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : date de début de la publication de l'entité. Pour `PublicationEvent`, il s'agit de la date de sortie initiale de cette entité, par exemple la date de la première sortie du film en salle. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début à laquelle l'entité est mise en avant ou exclusive.
`releasedEvent.endDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : s'applique uniquement aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date d'expiration des droits du contenu. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur présente l'entité. Si le contenu est exclusif ou mis en avant en permanence, définissez `endDate` sur 20 ans à compter de la date du jour.
`releasedEvent.publishedBy`	Organisation ou personne	Facultatif. Organisation ou personne ayant publié cette entité.
`description`	Texte	Fortement recommandé Pourquoi ? Un résumé de l'émission. Les résumés de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum. Utilisez un tableau pour baliser la description dans plusieurs langues. Consultez l'exemple Plusieurs régions et langues.
`actor`	Person, PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des acteurs de la série. Pour obtenir des conseils de modélisation, cliquez ici.
`director`	Personne	Fortement recommandé Pourquoi ? Le ou les réalisateurs de l'émission.
`producer`	Organisation ou personne	Fortement recommandé Pourquoi ? Producteur(s) de l'émission.
`image`	ImageObject	Obligatoire pour Google TV : images associées aux séries TV. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés de l'image.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple de bande-annonce.
`trailer.inLanguage`	Texte	Langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL d'une bande-annonce hébergée publiquement et mise en ligne par les studios de production respectifs ou des sources autorisées.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau de popularité d'une entité est défini sur 0.
`popularityScore.@type`	Texte	Toujours défini sur `PopularityScoreSpecification`.
`popularityScore.value`	Number	Valeur numérique non négative indiquant la popularité de l'entité. un score élevé signifie une popularité plus élevée.
`popularityScore.eligibleRegion`	Pays	Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).
`review`	Avis	Consulter les avis sur la série TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni Cette valeur permet de spécifier la note attribuée à l'avis.
`contentRating`	Text ou Rating	Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas : classification globale du contenu. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées: L'agence de notation a été ajoutée avant la note par un espace blanc. Par exemple, "TV-MA" note de l'agence "TVPG" aux États-Unis doit être désigné par la mention "TVPG TV-MA". Consultez la liste des agences. La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Texte ou Organisation	Obligatoire si `contentRating` utilise `Rating` : nom de l'agence de classification. Consultez la page Agences de classification de contenu pour consulter la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la note.
`contentRating.advisoryCode`	Texte	Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.

TVEpisode

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : toujours défini sur `["http://schema.org", {"@language": "xx"}]` Où ?" xx pouces représente la langue des chaînes du flux. La balise @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres est l'anglais.
`@type`	Texte	Obligatoire : toujours défini sur `TVEpisode`.
`@id`	URL	Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit remplir les conditions suivantes: Unique au niveau mondial dans votre catalogue L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel. Sous la forme d'un identifiant de ressource unifié (URI) Le domaine utilisé pour la valeur @id doit appartenir à votre organisation. Étant donné que le `url` d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut `url` d'une entité en tant que `@id`. Pour en savoir plus, consultez la section Identifiant.
`url`	URL	Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données. `url` doit respecter les exigences suivantes : `url` doit être unique `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour le lien profond de la lecture, consultez plutôt la propriété `urlTemplate` de l'objet cible.
`name`	Texte	Obligatoire : nom de l'épisode. Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Représentation dans plusieurs langages. Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? : identifiant EIDR (Entertainment Identifier Registry) représentant au niveau le plus général/abstrait d'une œuvre de film ou de télévision. Exemple : titre EIDR du premier épisode de la première saison de l'émission télévisée "Game of Thrones" est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Texte	Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant le montage / l'édition d'une œuvre d'un film ou d'une émission télévisée. Par exemple, le premier épisode de la première saison de l'émission télévisée "Game of Thrones", dont le titre EIDR est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", comporte un montage (ex. : "10.5240/FB97-C847-2969-D0AB-ECD1-C". La propriété `titleEIDR` est obligatoire lorsque le montage EIDR est fourni.
`inLanguage`	Texte	Langue d'origine de la série au format BCP 47.
`episodeNumber`	Entier	Obligatoire : numéro indiquant la position de l'épisode dans l'ordre des épisodes d'une saison. `episodeNumber` doivent redémarrer pour chaque saison ; Autrement dit, le premier épisode de chaque saison doit être 1.
`partOfSeason`	TVSeason	Obligatoire : saison de série TV à laquelle appartient cet épisode. Même si une `TVEpisode` n'a pas de `TVSeason` correspondante, vous devez quand même fournir les propriétés `partOfSeason.@id` et `partOfSeason.seasonNumber`. Voici une solution: Prenez `partofSeries.@id` (par exemple, http://www.example.com/my_favorite_tv_show) et joignez un champ de requête d'espace réservé (par exemple, http://www.example.com/my_favorite_tv_show) pour créer une `partOfSeason.@id` unique (par exemple, http://www.example.com/my_favorite_tv_show). Définissez `partOfSeason.seasonNumber` sur 1.
`partOfSeason.@type`	Texte	Obligatoire : toujours défini sur `TVSeason`.
`partOfSeason.@id`	URL	Obligatoire : `@id` de la propriété `TVSeason` dont cet épisode fait partie.
`partOfSeason.seasonNumber`	Entier	Obligatoire : numéro indiquant la position de la saison dans l'ordre des saisons de la série TV.
`partOfSeries`	TVSeries	Obligatoire : série TV à laquelle appartient cet épisode.
`partOfSeries.@type`	Texte	Obligatoire : toujours défini sur `TVSeries`.
`partOfSeries.@id`	URL	Obligatoire : `@id` de la propriété `TVSeries` dont cet épisode fait partie.
`partOfSeries.name`	Texte	Obligatoire : nom de la série TV.
`partOfSeries.sameAs`	Texte	URL d'une page Web de référence permettant d'identifier l'émission. par exemple, la page Wikipédia de l'émission. Elle doit être distincte de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire, le cas échéant : un objet de balisage Action qui fournit les détails de l'action. Si le contenu est disponible pour la vidéo à la demande (VoD), cette propriété est obligatoire. L'objet de balisage Action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. À la place, l'entité `BroadcastService` associée fournit le lien profond du canal. Un `TVEpisode` peut être disponible à la fois sur VoD et LiveTV. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
`sameAs`	Fortement recommandé Pourquoi ? URL	URL d'une page Web de référence pouvant identifier l'épisode. par exemple, la page Wikipédia de l'épisode. Elle doit être distincte de la propriété `url`.
`duration`	Durée	Durée d'exécution de l'épisode au format ISO 8601. Veuillez utiliser le format suivant : "PT00H00M".
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement recommandé Pourquoi ? - Un `PublicationEvent` permet d'indiquer la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme sa date de sortie en salle. Vous pouvez également utiliser `FeaturedEvent` pour indiquer que votre service commercialise ce contenu en tant que contenu original, sélectionné, spécial, etc. `ExclusiveEvent` indique que votre service dispose de droits de distribution exclusifs, et inclut où et quand. Consultez la section Exemples pour obtenir des détails et des exemples.
`releasedEvent.@type`	Texte	Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes : `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Pays	Obligatoire : régions associées à cet événement. Pour une `PublicationEvent`, il s'agit de la région dans laquelle le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région où le contenu est présenté ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer partout dans le monde, définissez la valeur sur `EARTH`.
`releasedEvent.startDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : date de début de la publication de l'entité. Pour `PublicationEvent`, il s'agit de la date de sortie initiale de cette entité, par exemple la date de la première sortie du film en salle. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début à laquelle l'entité est mise en avant ou exclusive.
`releasedEvent.endDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : s'applique uniquement aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date d'expiration des droits du contenu. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur présente l'entité. Si le contenu est exclusif ou mis en avant en permanence, définissez `endDate` sur 20 ans à compter de la date du jour.
`releasedEvent.publishedBy`	Organisation ou personne	Facultatif. Organisation ou personne ayant publié cette entité.
`description`	Texte	Fortement recommandé Pourquoi ? Un résumé de l'épisode. Les résumés de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum. Utilisez un tableau pour baliser la description dans plusieurs langues. Consultez l'exemple Représentation dans plusieurs langages.
`genre`	Texte	Liste numérotée de tous les genres pertinents. Par exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés permettant de décrire le contenu.
`actor`	Person, PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des acteurs de l'épisode. Pour obtenir des conseils de modélisation, cliquez ici.
`director`	Personne	Fortement recommandé Pourquoi ? Réalisateur(s) de l'épisode.
`producer`	Organisation ou personne	Fortement recommandé Pourquoi ? Producteur(s) de la saison.
`image`	ImageObject	Pourquoi fortement recommandé pour Google TV : différentes images liées à "TVEpisode". Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés de l'image.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple de bande-annonce.
`trailer.inLanguage`	Texte	Langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL d'une bande-annonce hébergée publiquement et mise en ligne par les studios de production respectifs ou des sources autorisées.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
`review`	Avis	Voir les classifications pour l'épisode de série TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni Cette valeur permet de spécifier la note attribuée à l'avis.
`contentRating`	Text ou Rating	Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas : classification globale du contenu. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées: L'agence de notation a été ajoutée avant la note par un espace blanc. Par exemple, "TV-MA" note de l'agence "TVPG" aux États-Unis doit être désigné par la mention "TVPG TV-MA". Consultez la liste des agences. La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Texte ou Organisation	Obligatoire si `contentRating` utilise `Rating` : nom de l'agence de classification. Consultez la page Agences de classification de contenu pour consulter la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la note.
`contentRating.advisoryCode`	Texte	Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.
`identifier`	PropertyValue	Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau de popularité d'une entité est défini sur 0.
`popularityScore.@type`	Texte	Toujours défini sur `PopularityScoreSpecification`.
`popularityScore.value`	Number	Valeur numérique non négative indiquant la popularité de l'entité. un score élevé signifie une popularité plus élevée.
`popularityScore.eligibleRegion`	Pays	Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).

TVSeason

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : toujours défini sur `["http://schema.org", {"@language": "xx"}]` Où ?" xx pouces représente la langue des chaînes du flux. La balise @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres est l'anglais.
`@type`	Texte	Obligatoire : toujours défini sur `TVSeason`.
`@id`	URL	Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit remplir les conditions suivantes: Unique au niveau mondial dans votre catalogue L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel. Sous la forme d'un identifiant de ressource unifié (URI) Le domaine utilisé pour la valeur @id doit appartenir à votre organisation. Étant donné que le `url` d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut `url` d'une entité en tant que `@id`. Pour en savoir plus, consultez la section Identifiant.
`url`	URL	Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données. `url` doit respecter les exigences suivantes : `url` doit être unique `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour le lien profond de la lecture, consultez plutôt la propriété `urlTemplate` de l'objet cible.
`name`	Texte	Obligatoire : nom de la saison de série TV. Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Représentation dans plusieurs langages. Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? : identifiant EIDR (Entertainment Identifier Registry) représentant au niveau le plus général/abstrait d'une œuvre de film ou de télévision. Exemple : titre EIDR de la première saison de l'émission télévisée "Game of Thrones" est "10.5240/FD91-C72C-4161-FCBA-058B-1".
`seasonNumber`	Entier	Obligatoire : numéro indiquant la position de la saison dans l'ordre des saisons de la série TV.
`partOfSeries`	TVSeries	Obligatoire : série TV à laquelle appartient cette saison.
`partOfSeries.@type`	Texte	Obligatoire : toujours défini sur `TVSeries`.
`partOfSeries.@id`	URL	Obligatoire : `@id` des `TVSeries` auxquels cette saison fait partie.
`partOfSeries.name`	Texte	Obligatoire : nom de la série TV.
`partOfSeries.sameAs`	Texte	URL d'une page Web de référence permettant d'identifier l'émission. par exemple, la page Wikipédia de l'émission. Elle doit être distincte de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire, le cas échéant : un objet de balisage Action qui fournit les détails de l'action. Si le contenu est disponible pour la vidéo à la demande (VoD), cette propriété est obligatoire. L'objet de balisage Action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. À la place, l'entité `BroadcastService` associée fournit le lien profond du canal. Un `TVSeason` peut être disponible à la fois sur VoD et LiveTV. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
`sameAs`	URL	Fortement recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier la saison. par exemple, la page Wikipédia de la saison. Elle doit être distincte de la propriété `url`.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement recommandé Pourquoi ? - Un `PublicationEvent` permet d'indiquer la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme sa date de sortie en salle. Vous pouvez également utiliser `FeaturedEvent` pour indiquer que votre service commercialise ce contenu en tant que contenu original, sélectionné, spécial, etc. `ExclusiveEvent` indique que votre service dispose de droits de distribution exclusifs, et indique où et quand. Consultez la section Exemples pour obtenir des détails et des exemples.
`releasedEvent.@type`	Texte	Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes : `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Pays	Obligatoire : régions associées à cet événement. Pour une `PublicationEvent`, il s'agit de la région dans laquelle le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région où le contenu est présenté ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer partout dans le monde, définissez la valeur sur `EARTH`.
`releasedEvent.startDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : date de début de la publication de l'entité. Pour `PublicationEvent`, il s'agit de la date de sortie initiale de cette entité, par exemple la date de la première sortie du film en salle. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début à laquelle l'entité est mise en avant ou exclusive.
`releasedEvent.endDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : s'applique uniquement aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date d'expiration des droits du contenu. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur présente l'entité. Si le contenu est exclusif ou mis en avant en permanence, définissez `endDate` sur 20 ans à compter de la date du jour.
`releasedEvent.publishedBy`	Organisation ou personne	Facultatif. Organisation ou personne ayant publié cette entité.
`description`	Texte	Fortement recommandé Pourquoi ? Résumé de la saison. Les résumés de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum. Utilisez un tableau pour baliser la description dans plusieurs langues. Consultez l'exemple Représentation dans plusieurs langages.
`actor`	[Person ou PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des acteurs de la saison. Pour obtenir des conseils de modélisation, cliquez ici.
`director`	Personne	Fortement recommandé Pourquoi ? Tableau des réalisateurs de l'émission.
`producer`	Organisation ou personne	Fortement recommandé Pourquoi ? Producteur(s) de la saison.
`image`	ImageObject	Images associées à la saison télévisée. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés de l'image.
`genre`	Texte	Liste numérotée de tous les genres pertinents. Par exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés permettant de décrire le contenu.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple de bande-annonce.
`trailer.inLanguage`	Texte	Langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL d'une bande-annonce hébergée publiquement et mise en ligne par les studios de production respectifs ou des sources autorisées.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau de popularité d'une entité est défini sur 0.
`popularityScore.@type`	Texte	Toujours défini sur `PopularityScoreSpecification`.
`popularityScore.value`	Number	Valeur numérique non négative indiquant la popularité de l'entité. un score élevé signifie une popularité plus élevée.
`popularityScore.eligibleRegion`	Pays	Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).
`review`	Avis	Voir les notes pour la saison de série TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni Cette valeur permet de spécifier la note attribuée à l'avis.
`contentRating`	Text ou Rating	Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas : classification globale du contenu. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées: L'agence de notation a été ajoutée avant la note par un espace blanc. Par exemple, "TV-MA" note de l'agence "TVPG" aux États-Unis doit être désigné par la mention "TVPG TV-MA". Consultez la liste des agences. La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Texte ou Organisation	Obligatoire si `contentRating` utilise `Rating` : nom de l'agence de classification. Consultez la page Agences de classification de contenu pour consulter la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la note.
`contentRating.advisoryCode`	Texte	Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.

Spécifications des acteurs

La propriété actor dans les types d'entités TVSeries, TVEpisode et TVSeason vous permet de spécifier plus de détails sur les acteurs, y compris le nom de leurs personnages et les rôles qu'ils jouent dans la série TV. La ou les sections suivantes en détaillent l'utilisation, accompagnées de quelques exemples.

Propriété Type attendu Description

Propriété	Type attendu	Description
`actor`	Person, PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? : tableau des membres de la distribution. Utilisez le type PerformanceRole lorsque le rôle a été joué et (éventuellement) le nom du ou des personnages de la distribution est connu. Dans ce cas, l'acteur Person ou PerformingGroup est intégré à l'objet PerformanceRole. Utilisez le type Person pour indiquer le ou les acteurs individuels ou le type PerformingGroup pour fournir des informations sur les groupes actifs lorsque le rôle joué par les acteurs n'est pas connu. Utilisez un tableau pour représenter plusieurs "Persons", "PerformGroups" ou "PerformanceRoles".

actor

Person, PerformingGroup ou PerformanceRole

Fortement recommandé Pourquoi ? : tableau des membres de la distribution.

Utilisez le type PerformanceRole lorsque le rôle a été joué et (éventuellement) le nom du ou des personnages de la distribution est connu. Dans ce cas, l'acteur Person ou PerformingGroup est intégré à l'objet PerformanceRole.
Utilisez le type Person pour indiquer le ou les acteurs individuels ou le type PerformingGroup pour fournir des informations sur les groupes actifs lorsque le rôle joué par les acteurs n'est pas connu.

Utilisez un tableau pour représenter plusieurs "Persons", "PerformGroups" ou "PerformanceRoles".

Utiliser les types `Person` ou `PerformingGroup`

Fournissez les propriétés suivantes lorsque le type Person ou PerformingGroup est utilisé

Propriété	Type attendu	Description
`@type`	Person ou PerformingGroup	Required : toujours défini sur Person ou PerformingGroup
`@id`	URL	Fortement recommandé Pourquoi ? - L'identifiant des acteurs ou du groupe d'exécution au format URI par exemple https://example.com/actor/abc. `@id` doit répondre aux exigences suivantes: Unique au niveau mondial dans votre catalogue par acteur/groupe performant Cet identifiant doit être stable et immuable dans le temps. Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel. Sous la forme d'un identifiant de ressource unifié (URI) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que le `@id` utilisé dans la propriété de l'acteur doit être utilisé de manière cohérente dans tout le flux. Par exemple, s'il y a deux films avec le même acteur, la valeur `@id` doit être la même pour ces deux objets d'acteur.
`name`	Texte	Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe d'acteurs.
`sameAs`	URL	Fortement recommandé Pourquoi ? – Une URL vers une page Web de référence qui peut identifier l'acteur ou le groupe actif par exemple, la page Wikipédia de l'acteur. Elle doit être distincte de la propriété `@id`.

Utiliser le type `PerformanceRole`

Fournissez les propriétés suivantes lorsque le type PerformanceRole est utilisé

Propriété	Type attendu	Description
`@type`	PerformanceRole	Obligatoire : toujours défini sur PerformanceRole
`roleName`	Texte	Fortement recommandé Pourquoi ? : rôle joué, interprété ou rempli par l'acteur. Pour consulter la liste des valeurs acceptées, cliquez ici.
`characterName`	Texte	Nom d'un personnage occupant un rôle d'acteur ou de danse. Ne définissez pas ce champ si le type d'acteur est PerformingGroup.
`actor`	Person ou PerformingGroup	Obligatoire - Membres de la distribution du contenu lorsque le type de données Person est utilisé. Groupe(s) d'exécution/bande(s) du contenu lorsque le type de données PerformingGroup est utilisé.
`actor.@type`	Person ou PerformingGroup	Required : toujours défini sur Person ou PerformingGroup
`actor.@id`	URL	Fortement recommandé Pourquoi ? - L'identifiant de l'acteur ou du groupe d'exécution au format URI par exemple https://example.com/actor/abc. `@id` doit répondre aux exigences suivantes: Unique au niveau mondial dans votre catalogue par acteur/groupe performant Cet identifiant doit être stable et immuable dans le temps. Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel. Sous la forme d'un identifiant de ressource unifié (URI) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que le `@id` utilisé dans la propriété de l'acteur doit être utilisé de manière cohérente dans tout le flux. Par exemple, s'il y a deux films avec le même acteur, la valeur `@id` doit être la même pour ces deux objets d'acteur.
`actor.name`	Texte	Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe d'acteurs.
`actor.sameAs`	URL	Fortement recommandé Pourquoi ? – Une URL vers une page Web de référence qui peut identifier l'acteur ou le groupe actif par exemple, la page Wikipédia de l'acteur. Il doit être distinct de la propriété actor.@id.

Noms de rôles autorisés

Ces valeurs nécessitent que actor.@type soit Person.

Valeur `roleName`	Description
"Cameo"	Un rôle de caméo, également appelé apparition de caméo, est une brève apparition d'une personne connue dans une œuvre des arts du spectacle.
"VoiceActor"	Il s'agit d'une représentation vocale dans laquelle la voix d'un acteur est utilisée, mais n'apparaît pas à l'écran. Ce phénomène se rencontre le plus souvent dans les animations, mais il se produit également lorsque la voix d'un acteur est doublée plutôt que le discours d'un autre acteur.
"Double"	Un double est une personne qui se substitue à un autre acteur de sorte que son visage ne soit pas visible.
"MotionCaptureActor"	Un MotionCaptureActor fait référence à une personne qui enregistre les actions d'acteurs humains et utilise ces informations pour animer des modèles de personnages numériques en 2D ou 3D.

Ces valeurs sont généralement acceptées pour les types Person et PerformingGroup.

Valeur `roleName`	Description
"Acteur"	Un acteur ou une actrice est une personne qui incarne un personnage dans un spectacle sur un support traditionnel au théâtre ou dans des médias modernes tels que le cinéma, la radio et la télévision.
"GuestStar"	"Un invité vedette est un acteur qui joue un rôle fictif et apparaît dans un ou plusieurs épisodes. Dans certains cas, une invité vedette peut incarner un personnage récurrent important et apparaître plusieurs fois dans une série, même si elle ne fait pas partie de la distribution principale. Définir la valeur sur "GuestStar" lorsque les acteurs interviennent dans l'émission ou en tant qu'invité. Les invités vedettes ne doivent être fournis qu'au niveau de l'épisode et ne doivent pas être ajoutés au niveau de la série TV.
"Invité"	"Un invité à un talk-show. Notez que même si "GuestStar" est un rôle fictif, "Invité" est une apparence non fictive.
"Présentateur"	Un présentateur est une personne qui présente les spiels d'ouverture et de clôture pour le spectacle, présente l'animateur, les participants et/ou les invités célèbres, décrit les prix disponibles, réchauffe le public avant l'enregistrement et le divertit pendant les pauses.
"Commentateur"	Un commentateur commente en temps réel un match ou un événement, généralement pendant une diffusion en direct.
"Impressionniste"	Un impressionniste ou un imposteur est un artiste qui consiste à imiter les sons, les voix et les maniérismes de célébrités et de personnages de dessins animés.
"Hôte"	Personne qui présente, présente ou anime des émissions télévisées, souvent médiateur de l'émission et de l'audience. L'hôte n'est généralement pas qu'un poste de fiction.
"Coorganisateur"	Personne qui organise un événement/programme en collaboration avec une ou plusieurs autres personnes.
"Hôte Invité"	Un organisateur invité est l'organisateur, généralement d'un talk-show, qui anime le programme à la place de l'organisateur habituel lorsqu'il n'est pas disponible.
"Présentateur"	Personne qui présente ou informe le public de l'actualité et des événements à l'échelle locale, nationale et internationale par le biais d'une émission télévisée d'actualités.
« Correspondant »	Un correspondant ou un reporter est généralement un journaliste ou un commentateur pour un magazine, ou un agent qui contribue à des reportages dans un journal, un journal radio ou télévisé, ou un autre type d'entreprise, depuis un lieu distant, souvent éloigné.
"ShowJudge"	Un juge est une personne souvent considérée comme un expert dans le domaine de l'émission et qui se voit attribuer le rôle de "juge". pour critiquer les candidats qui auditionnent pour la série télévisée et y participent.
"Panneaux"	Membre d'un groupe de discussion ou consultatif d'un groupe de radio ou de télévision
"Participant"	Un participant à une compétition ou à un jeu télévisé est une personne qui y participe.
"StoryNarrator"	Le narrateur est une personne qui raconte quelque chose, en particulier un personnage qui racontent les événements d'un roman ou d'un poème narratif.
"MusicalArtist"	"Un artiste musical est une personne, un groupe ou un personnage fictif qui se produit généralement devant un public, ou qui a enregistré des morceaux ou des albums musicaux. Les compositeurs et les paroliers ne doivent utiliser cette catégorie que si le générique de certaines œuvres musicales implique qu'ils sont également l'artiste principal. Ce type peut être utilisé pour associer des musiciens ou des groupes de musiciens permanents, ainsi que des musiciens ou des groupes de musiciens invités, à des spectacles.

Faire la différence entre le rôle principal et le rôle secondaire d'un acteur

Pour distinguer les acteurs principaux/habituels d'une émission télévisée, d'autres invités/secondaires, ajoutez la distribution principale sur les entités TVSeries uniquement, et ajoutez uniquement la distribution ou la distribution de l'invité avec des rôles secondaires sur les entités TVEpisode. Assurez-vous que la diffusion principale/standard n'est pas ajoutée aux entités TVEpisode.

Exemples

Exemple pour `TVSeries`, `TVEpisode` et `TVSeason`

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Exemples de propriétés `Actor`

Le rôle de l'acteur est inconnu

Lorsque le rôle d'un acteur n'est pas connu, nous vous recommandons de lui fournir des informations à l'aide du type Person ou PerformingGroup

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Le rôle de l'acteur est connu

Lorsque le rôle d'un acteur est connu, nous recommandons de lui fournir des informations à l'aide du type

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Rôles connus pour un sous-ensemble d'acteurs

Lorsque les métadonnées du rôle de performance ne sont pas connues, nous vous recommandons de fournir des informations sur l'acteur à l'aide du type Person ou PerformingGroup . Dans l'autre cas où cette information est connue, utilisez le type PerformanceRole . Ces types peuvent être ajoutés ensemble dans le même tableau.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

Propriétés de balisage de contenu des émissions télévisées

Tableau des spécifications

TVSeries

TVEpisode

TVSeason

Spécifications des acteurs

Utiliser les types Person ou PerformingGroup

Utiliser le type PerformanceRole

Noms de rôles autorisés

Faire la différence entre le rôle principal et le rôle secondaire d'un acteur

Exemples

Exemple pour TVSeries, TVEpisode et TVSeason

TVSeries

TVEpisode

TVSeason

Exemples de propriétés Actor

Le rôle de l'acteur est inconnu

Le rôle de l'acteur est connu

Rôles connus pour un sous-ensemble d'acteurs

À lire également

Utiliser les types `Person` ou `PerformingGroup`

Utiliser le type `PerformanceRole`

Exemple pour `TVSeries`, `TVEpisode` et `TVSeason`

Exemples de propriétés `Actor`