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.

Il est facultatif de fournir TVSeason en tant qu'entité complète. Pour en savoir plus, consultez la section Relations TVSeries, TVSeason et TVEpisode.

Tableau des spécifications

TVSeries

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : toujours défini sur `["http://schema.org", {"@language": "xx"}]` Où"xx" représente la langue des chaînes dans le flux. Pour chaque contexte d'entité racine, le champ @language doit être défini 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 ou du doublage 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 répondre aux exigences suivantes : Unique dans l'ensemble de votre catalogue Cet identifiant doit être stable et immuable dans le temps (même si la propriété 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 uniforme (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 le `url` d'une entité comme `@id`. Pour en savoir plus, consultez la section Identifiant.
`url`	URL	Obligatoire : URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux à celui des bases de données de Google. `url` doit répondre aux 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 target.
`name`	Texte	Obligatoire : nom de la série. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? - Un EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle. Par exemple, l'EIDR du titre de la série télévisée "Game of Thrones" est "10.5240/C1B5-3BA1-8991-A571-8472-W".
`potentialAction`	WatchAction	Obligatoire, le cas échéant : un objet de balisage d'action qui fournit les détails de l'action. Cette propriété est obligatoire si le contenu est disponible en vidéo à la demande (VOD). L'objet de balisage d'action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne de télévision en direct, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne à la place. Un `TVSeries` peut être disponible à la fois en VOD et en Live TV. 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 série (par exemple, la page Wikipédia de la série). Elle doit être différente de la propriété `url`.
`inLanguage`	Texte	Fortement recommandé : langue d'origine de la série au format BCP 47.
`genre`	Texte	Liste ordonnée de tous les genres concernés. 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, ["feature, biography"] peut être un tableau de mots clés décrivant le contenu.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement recommandé Pourquoi ? - `PublicationEvent` permet de spécifier la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme la date de sortie en salle d'un film. De plus, utilisez `FeaturedEvent` pour indiquer que votre service commercialise ce contenu comme un contenu original, mis en avant, spécial, etc. `ExclusiveEvent` indique que votre service dispose des droits de distribution exclusifs et précise où et quand. Pour en savoir plus et obtenir des exemples, consultez la section d'exemples.
`releasedEvent.@type`	Texte	Obligatoire : veillez à 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 un `PublicationEvent`, il s'agit de la région où le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région où le contenu est mis en avant ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer tous les pays du 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 un `PublicationEvent`, il s'agit de la date de sortie initiale de cette entité, par exemple la date à laquelle un film est sorti pour la première fois au cinéma. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de l'exclusivité ou de la mise en avant de l'entité.
`releasedEvent.endDate`	Date ou DateTime	Recommandé – Obligatoire pour `ExclusiveEvent` : ne s'applique qu'aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date d'expiration des droits sur le contenu. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur met en avant l'entité. Si le contenu est exclusif ou mis en avant de manière permanente, définissez `endDate` sur 20 ans à compter de la date actuelle.
`releasedEvent.publishedBy`	Organization ou Person	Facultatif : organisation ou personne ayant publié cette entité.
`description`	Texte	Fortement recommandé Pourquoi ? Synopsis de la série Les résumés d'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 sur la modélisation, cliquez ici.
`director`	Personne	Fortement recommandé Pourquoi ? Réalisateur(s) de la série.
`producer`	Organization ou Person	Fortement recommandé Pourquoi ? Producteur(s) de la série.
`image`	ImageObject	Obligatoire pour Google TV : images associées à la série TV. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés des images.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple Bande-annonce.
`trailer.inLanguage`	Texte	Fortement recommandé : langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL d'une bande-annonce hébergée publiquement et importée par les studios de production concernés ou des sources autorisées.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si cette information n'est pas spécifiée, la vidéo est considérée comme autorisée partout. Spécifiez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie clairement cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente dans vos flux, pour toutes les entités de votre catalogue. Par défaut, le score 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é. Plus le score est élevé, plus la popularité est élevée.
`popularityScore.eligibleRegion`	Pays	Région(s) où ce score de popularité est applicable. Si le score de popularité est applicable au niveau mondial, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique à une langue prévaut sur la popularité mondiale (TERRE)
`review`	Avis	Consulter les classifications de la série TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni. Cette valeur permet de spécifier la note attribuée dans 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 fournie sous la forme d'une chaîne de texte, deux variantes sont acceptées : Agence de notation précédant la note, avec un espace entre les deux. Par exemple, une classification "TV-MA" de l'agence "TVPG" aux États-Unis doit être décrite comme "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`	Entreprise	Obligatoire si `contentRating` utilise `Rating` : nom de l'agence de classification. Consultez la page Organismes de classification du contenu pour obtenir la liste des organismes de classification acceptés.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la classification.
`contentRating.advisoryCode`	Texte	Code d'avertissement pour le contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langage, 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" représente la langue des chaînes dans le flux. Pour chaque contexte d'entité racine, le champ @language doit être défini 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 ou du doublage 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 répondre aux exigences suivantes : Unique dans l'ensemble de votre catalogue Cet identifiant doit être stable et immuable dans le temps (même si la propriété 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 uniforme (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 le `url` d'une entité comme `@id`. Pour en savoir plus, consultez la section Identifiant.
`url`	URL	Obligatoire : URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux à celui des bases de données de Google. `url` doit répondre aux 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 target.
`name`	Texte	Obligatoire : nom de l'épisode. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Représentation de plusieurs langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? - Un EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle. Par exemple, l'EIDR du titre du premier épisode de la première saison de la série 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 un montage ou une édition spécifique d'une œuvre cinématographique ou télévisuelle. Par exemple, le premier épisode de la première saison de la série TV "Game of Thrones", dont l'EIDR du titre est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", comporte un montage, par exemple "10.5240/FB97-C847-2969-D0AB-ECD1-C". La propriété `titleEIDR` est obligatoire lorsque editEIDR est fourni.
`inLanguage`	Texte	Fortement recommandé : langue d'origine de l'épisode au format BCP 47.
`episodeNumber`	Entier	Obligatoire : numéro indiquant la position de l'épisode dans l'ordre des épisodes d'une saison. `episodeNumber` doit redémarrer à chaque saison. Autrement dit, le premier épisode de chaque saison doit être 1.
`partOfSeason`	TVSeason	Obligatoire : saison TV à laquelle appartient cet épisode. Même si un `TVEpisode` n'a pas de `TVSeason` correspondant, vous devez quand même fournir les propriétés `partOfSeason.@id` et `partOfSeason.seasonNumber`. Pour contourner ce problème : Prenez `partofSeries.@id` (par exemple, http://www.example.com/ma_série_préférée) et ajoutez un espace réservé pour le champ de requête (par exemple, ?saison1) afin de créer un `partOfSeason.@id` unique (par exemple, http://www.example.com/ma_série_préférée?saison1). Définissez `partOfSeason.seasonNumber` sur 1.
`partOfSeason.@type`	Texte	Obligatoire : toujours défini sur `TVSeason`.
`partOfSeason.@id`	URL	Obligatoire : `@id` du `TVSeason` auquel appartient cet épisode.
`partOfSeason.seasonNumber`	Entier	Obligatoire : nombre indiquant la position de cette 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` du `TVSeries` auquel appartient cet épisode.
`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 la série (par exemple, la page Wikipédia de la série). Elle doit être différente de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire, le cas échéant : un objet de balisage d'action qui fournit les détails de l'action. Cette propriété est obligatoire si le contenu est disponible en vidéo à la demande (VOD). L'objet de balisage d'action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne de télévision en direct, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne à la place. Un `TVEpisode` peut être disponible à la fois sur la VOD et sur la TV en direct. 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 permettant d'identifier l'épisode (par exemple, la page Wikipédia de l'épisode). Elle doit être différente de la propriété `url`.
`duration`	Durée	Durée de l'épisode au format ISO 8601. Veuillez utiliser le format "PT00H00M".
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement recommandé Pourquoi ? - `PublicationEvent` permet de spécifier la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme la date de sortie en salle d'un film. De plus, utilisez `FeaturedEvent` pour indiquer que votre service commercialise ce contenu comme un contenu original, mis en avant, spécial, etc. `ExclusiveEvent` indique que votre service dispose des droits de distribution exclusifs et précise où et quand. Pour en savoir plus et obtenir des exemples, consultez la section des exemples.
`releasedEvent.@type`	Texte	Obligatoire : veillez à 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 un `PublicationEvent`, il s'agit de la région où le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région où le contenu est mis en avant ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer tous les pays du 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 un `PublicationEvent`, il s'agit de la date de sortie initiale de cette entité, par exemple la date à laquelle un film est sorti pour la première fois au cinéma. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de l'exclusivité ou de la mise en avant de l'entité.
`releasedEvent.endDate`	Date ou DateTime	Recommandé – Obligatoire pour `ExclusiveEvent` : ne s'applique qu'aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date d'expiration des droits sur le contenu. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur met en avant l'entité. Si le contenu est exclusif ou mis en avant de manière permanente, définissez `endDate` sur 20 ans à compter de la date actuelle.
`releasedEvent.publishedBy`	Organization ou Person	Facultatif : organisation ou personne ayant publié cette entité.
`description`	Texte	Fortement recommandé Pourquoi ? Synopsis de l'épisode. Les résumés d'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 de plusieurs langues.
`genre`	Texte	Liste ordonnée de tous les genres concernés. 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, ["feature, biography"] peut être un tableau de mots clés décrivant le contenu.
`actor`	Person, PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des acteurs de l'épisode. Pour obtenir des conseils sur la modélisation, cliquez ici.
`director`	Personne	Fortement recommandé Pourquoi ? Réalisateur(s) de l'épisode.
`producer`	Organization ou Person	Fortement recommandé Pourquoi ? Producteur(s) de la saison.
`image`	ImageObject	Recommandé Pourquoi ? pour Google TV : différentes images associées à l'épisode de série TV. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés des images.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple Bande-annonce.
`trailer.inLanguage`	Texte	Fortement recommandé : langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL d'une bande-annonce hébergée publiquement et importée par les studios de production concernés ou des sources autorisées.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si cette information n'est pas spécifiée, la vidéo est considérée comme autorisée partout. Spécifiez les pays au format ISO 3166.
`review`	Avis	Consulter les notes de l'épisode de série TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni. Cette valeur permet de spécifier la note attribuée dans 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 fournie sous la forme d'une chaîne de texte, deux variantes sont acceptées : Agence de notation précédant la note, avec un espace entre les deux. Par exemple, une classification "TV-MA" de l'agence "TVPG" aux États-Unis doit être décrite comme "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`	Entreprise	Obligatoire si `contentRating` utilise `Rating` : nom de l'agence de classification. Consultez la page Organismes de classification du contenu pour obtenir la liste des organismes de classification acceptés.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la classification.
`contentRating.advisoryCode`	Texte	Code d'avertissement pour le contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langage, S = Contenu à caractère sexuel, V = Violence.
`identifier`	PropertyValue	Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie clairement cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente dans vos flux, pour toutes les entités de votre catalogue. Par défaut, le score 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é. Plus le score est élevé, plus la popularité est élevée.
`popularityScore.eligibleRegion`	Pays	Région(s) où ce score de popularité est applicable. Si le score de popularité est applicable au niveau mondial, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique à une langue prévaut sur la popularité mondiale (TERRE)

TVSeason

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : toujours défini sur `["http://schema.org", {"@language": "xx"}]` Où"xx" représente la langue des chaînes dans le flux. Pour chaque contexte d'entité racine, le champ @language doit être défini 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 ou du doublage 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 répondre aux exigences suivantes : Unique dans l'ensemble de votre catalogue Cet identifiant doit être stable et immuable dans le temps (même si la propriété 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 uniforme (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 le `url` d'une entité comme `@id`. Pour en savoir plus, consultez la section Identifiant.
`url`	URL	Obligatoire : URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux à celui des bases de données de Google. `url` doit répondre aux 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 target.
`name`	Texte	Obligatoire : nom de la saison de série TV. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Représentation de plusieurs langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? - Un EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle. Par exemple, l'EIDR du titre de la première saison de la série TV "Game of Thrones" est "10.5240/FD91-C72C-4161-FCBA-058B-1".
`seasonNumber`	Entier	Obligatoire : nombre indiquant la position de cette 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` de la `TVSeries` à laquelle appartient cette saison.
`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 la série (par exemple, la page Wikipédia de la série). Elle doit être différente de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire, le cas échéant : un objet de balisage d'action qui fournit les détails de l'action. Cette propriété est obligatoire si le contenu est disponible en vidéo à la demande (VOD). L'objet de balisage d'action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne de télévision en direct, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne à la place. Un `TVSeason` peut être disponible à la fois sur la VOD et sur la TV en direct. 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 qui peut identifier la saison (par exemple, la page Wikipédia de la saison). Elle doit être différente de la propriété `url`.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement recommandé Pourquoi ? - Un `PublicationEvent` est utilisé pour spécifier la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme la date de sortie en salle d'un film. De plus, utilisez `FeaturedEvent` pour indiquer que votre service commercialise ce contenu comme un contenu original, mis en avant, spécial, etc. `ExclusiveEvent` indique que votre service dispose des droits de distribution exclusifs et précise où et quand. Consultez la section des exemples pour en savoir plus et voir des exemples.
`releasedEvent.@type`	Texte	Obligatoire : veillez à 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 un `PublicationEvent`, il s'agit de la région où le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région où le contenu est mis en avant ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer tous les pays du 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 un `PublicationEvent`, il s'agit de la date de sortie initiale de cette entité, par exemple la date à laquelle un film est sorti pour la première fois au cinéma. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de l'exclusivité ou de la mise en avant de l'entité.
`releasedEvent.endDate`	Date ou DateTime	Recommandé – Obligatoire pour `ExclusiveEvent` : ne s'applique qu'aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date d'expiration des droits sur le contenu. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur met en avant l'entité. Si le contenu est exclusif ou mis en avant de manière permanente, définissez `endDate` sur 20 ans à compter de la date actuelle.
`releasedEvent.publishedBy`	Organization ou Person	Facultatif : organisation ou personne ayant publié cette entité.
`description`	Texte	Fortement recommandé Pourquoi ? Synopsis de la saison. Les résumés d'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 de plusieurs langues.
`actor`	[Person ou PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des acteurs de la saison. Pour obtenir des conseils sur la modélisation, cliquez ici.
`director`	Personne	Fortement recommandé Pourquoi ? Tableau des réalisateurs de la série.
`producer`	Organization ou Person	Fortement recommandé Pourquoi ? Producteur(s) de la saison.
`image`	ImageObject	Images associées à la saison TV. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés des images.
`genre`	Texte	Liste ordonnée de tous les genres concernés. 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, ["feature, biography"] peut être un tableau de mots clés décrivant le contenu.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple Bande-annonce.
`trailer.inLanguage`	Texte	Fortement recommandé : langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL d'une bande-annonce hébergée publiquement et importée par les studios de production concernés ou des sources autorisées.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si cette information n'est pas spécifiée, la vidéo est considérée comme autorisée partout. Spécifiez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie clairement cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente dans vos flux, pour toutes les entités de votre catalogue. Par défaut, le score 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é. Plus le score est élevé, plus la popularité est élevée.
`popularityScore.eligibleRegion`	Pays	Région(s) où ce score de popularité est applicable. Si le score de popularité est applicable au niveau mondial, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique à une langue prévaut sur la popularité mondiale (TERRE)
`review`	Avis	Consulter les notes de la saison TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni. Cette valeur permet de spécifier la note attribuée dans 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 fournie sous la forme d'une chaîne de texte, deux variantes sont acceptées : Agence de notation précédant la note, avec un espace entre les deux. Par exemple, une classification "TV-MA" de l'agence "TVPG" aux États-Unis doit être décrite comme "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`	Entreprise	Obligatoire si `contentRating` utilise `Rating` : nom de l'agence de classification. Consultez la page Organismes de classification du contenu pour obtenir la liste des organismes de classification acceptés.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la classification.
`contentRating.advisoryCode`	Texte	Code d'avertissement pour le contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langage, S = Contenu à caractère sexuel, V = Violence.

Spécifications de l'acteur

La propriété actor des types d'entité TVSeries, TVEpisode et TVSeason vous permet de spécifier plus d'informations sur les acteurs, y compris le nom de leurs personnages et les rôles qu'ils jouent dans la série TV. Les sections suivantes reprennent ces informations et fournissent quelques exemples pour clarifier l'utilisation.

Propriété Type attendu Description

Propriété	Type attendu	Description
`actor`	Person, PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? : Tableau des acteurs. Utilisez le type PerformanceRole lorsque le rôle joué et (facultativement) le nom du personnage du ou des acteurs sont connus. L'acteur Person ou PerformingGroup est intégré à l'objet PerformanceRole dans ce cas. Utilisez le type Person pour indiquer le ou les acteurs individuels, ou PerformingGroup pour fournir des informations sur le ou les groupes/groupes musicaux lorsque le ou les rôles joués par les membres de la distribution sont inconnus. Utilisez un tableau pour représenter plusieurs personnes, groupes ou rôles de représentation.

actor

Person, PerformingGroup ou PerformanceRole

Fortement recommandé Pourquoi ? : Tableau des acteurs.

Utilisez le type PerformanceRole lorsque le rôle joué et (facultativement) le nom du personnage du ou des acteurs sont connus. L'acteur Person ou PerformingGroup est intégré à l'objet PerformanceRole dans ce cas.
Utilisez le type Person pour indiquer le ou les acteurs individuels, ou PerformingGroup pour fournir des informations sur le ou les groupes/groupes musicaux lorsque le ou les rôles joués par les membres de la distribution sont inconnus.

Utilisez un tableau pour représenter plusieurs personnes, groupes ou rôles de représentation.

Utiliser les types `Person` ou `PerformingGroup`

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

Propriété	Type attendu	Description
`@type`	Person ou PerformingGroup	Obligatoire : toujours défini sur Person ou PerformingGroup
`@id`	URL	Fortement recommandé Pourquoi ? - Identifiant des acteurs ou du groupe de représentation au format URI, par exemple https://example.com/actor/abc. `@id` doit répondre aux exigences suivantes : Unique dans votre catalogue pour chaque acteur/groupe d'artistes 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 uniforme (URI) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que la propriété `@id` utilisée dans la propriété actor doit être utilisée de manière cohérente dans l'ensemble du flux. Par exemple, si deux films mettent en scène le même acteur, la valeur `@id` doit rester la même pour ces deux objets acteur.
`name`	Texte	Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe de représentation.
`sameAs`	URL	Fortement recommandé Pourquoi ? - URL d'une page Web de référence permettant d'identifier l'acteur ou le groupe ; par exemple, la page Wikipédia de l'acteur. Elle doit être différente de la propriété `@id`.

Utiliser le type `PerformanceRole`

Indiquez 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 ? - Un rôle joué, interprété ou tenu par le membre de l'équipe. Pour consulter la liste des valeurs acceptables, cliquez ici.
`characterName`	Texte	Nom d'un personnage joué dans un rôle d'acteur ou d'interprète. Ne définissez pas ce champ si le type d'acteur est PerformingGroup.
`actor`	Person ou PerformingGroup	Obligatoire : Les acteurs du contenu lorsque le type de données Person est utilisé. Groupe(s)/Ensemble(s) interprète(s) du contenu lorsque le type de données PerformingGroup est utilisé.
`actor.@type`	Person ou PerformingGroup	Obligatoire : toujours défini sur Person ou PerformingGroup
`actor.@id`	URL	Fortement recommandé Pourquoi ? - Identifiant de l'acteur ou du groupe de représentation au format URI (par exemple, https://example.com/actor/abc). `@id` doit répondre aux exigences suivantes : Unique dans votre catalogue pour chaque acteur/groupe d'artistes 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 uniforme (URI) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que la propriété `@id` utilisée dans la propriété actor doit être utilisée de manière cohérente dans l'ensemble du flux. Par exemple, si deux films mettent en scène le même acteur, la valeur `@id` doit rester la même pour ces deux objets acteur.
`actor.name`	Texte	Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe de représentation.
`actor.sameAs`	URL	Fortement recommandé Pourquoi ? - URL d'une page Web de référence permettant d'identifier l'acteur ou le groupe ; par exemple, la page Wikipédia de l'acteur. Elle doit être distincte de la propriété actor.@id.

Noms de rôle acceptés

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

Valeur `roleName`	Description
"Cameo"	Un cameo est une brève apparition d'une personne célèbre dans une œuvre des arts du spectacle.
"VoiceActor"	Une performance vocale est une performance dans laquelle la voix de l'acteur est utilisée, mais l'acteur n'apparaît pas à l'écran. Cette technique est surtout utilisée dans l'animation, mais elle se produit également lorsqu'un acteur est doublé par un autre.
"Double"	Une doublure est une personne qui remplace un autre acteur de sorte que son visage n'est pas montré.
"MotionCaptureActor"	Un MotionCaptureActor désigne une personne qui enregistre les actions d'acteurs humains et utilise ces informations pour animer des modèles de personnages numériques dans des animations informatiques 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 interprète un personnage dans une représentation théâtrale ou dans des médias modernes tels que le cinéma, la radio et la télévision.
"GuestStar"	"Une guest star est un acteur qui joue un rôle fictif et apparaît dans un ou plusieurs épisodes. Dans certains cas, une guest star peut jouer 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éfinissez la valeur sur "GuestStar" lorsque la distribution comprend une performance ou une participation spéciale. Les guest stars ne doivent être indiquées qu'au niveau de l'épisode et ne doivent pas être ajoutées au niveau de la série TV.
"Invité"	"Un invité dans un talk-show. Notez que "GuestStar" est un rôle fictif, tandis que "Guest" est une apparition non fictive.
"Announcer" (Annonceur)	Un présentateur est une personne qui présente l'émission, l'animateur, les candidats et/ou les invités célèbres, décrit les prix disponibles et chauffe le public avant l'enregistrement, puis le divertit pendant les pauses.
"Commentateur"	Un commentateur fournit des commentaires en temps réel sur un match ou un événement, généralement lors d'une diffusion en direct.
"Impressionniste"	Un imitateur est un artiste dont le numéro consiste à imiter les sons, les voix et les manières de célébrités et de personnages de dessins animés.
"Hôte"	Personne qui présente ou anime des programmes télévisés, souvent en servant de médiateur entre le programme et l'audience. Le rôle d'animateur est généralement un rôle non fictif.
"CoHost"	Personne qui anime un événement ou un programme conjointement avec une ou plusieurs autres personnes.
"GuestHost"	Un animateur remplaçant est un animateur, généralement d'un talk-show, qui anime l'émission à la place de l'animateur habituel lorsqu'il n'est pas disponible.
"Newscaster"	Personne qui présente/informe le public sur les actualités et les événements locaux, nationaux et internationaux dans un programme d'information télévisé.
"Correspondant"	Un correspondant ou un reporter sur le terrain est généralement un journaliste ou un commentateur pour un magazine, ou un agent qui contribue à des reportages pour un journal, une radio, une chaîne de télévision ou un autre type d'entreprise, depuis un lieu éloigné, souvent distant.
"ShowJudge"	Un juge est une personne souvent considérée comme un expert dans le domaine de l'émission. Il est chargé de critiquer les candidats qui auditionnent et participent à la compétition de la série télévisée.
"Panelist"	Membre d'un groupe de discussion ou d'un comité consultatif d'un panel radio ou télévisé.
"Participant"	Un candidat à un concours ou à un jeu télévisé est une personne qui y participe.
"StoryNarrator"	Un narrateur est une personne qui raconte quelque chose, en particulier un personnage qui raconte les événements d'un roman ou d'un poème narratif.
"MusicalArtist"	"Un artiste musical peut être une personne, un groupe ou un personnage de fiction qui s'est généralement produit régulièrement devant un public ou qui a enregistré des titres ou des albums musicaux. Les compositeurs et les paroliers ne doivent avoir ce type que si les crédits d'une œuvre musicale impliquent qu'ils contribuent également en tant qu'interprètes principaux. Ce type peut être utilisé pour associer des musiciens ou des groupes de musiciens permanents et invités à des émissions.

Différencier le rôle principal et le rôle secondaire d'un acteur

Pour faire la différence entre les acteurs principaux/habituels et les acteurs secondaires/invités dans une série télévisée, n'ajoutez la distribution principale que sur les entités TVSeries et n'ajoutez que la distribution invitée ou la distribution avec des rôles secondaires sur les entités TVEpisode. Assurez-vous que les acteurs principaux/habituels ne sont pas ajoutés aux entités TVEpisode.

Exemples

Exemple de `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 est inconnu, nous vous recommandons de simplement fournir les informations sur l'acteur à 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 vous recommandons de fournir les informations sur l'acteur à l'aide du type PerformanceRole.

"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 sur le rôle de l'artiste ne sont pas connues, nous vous recommandons de fournir les informations sur l'acteur à l'aide du type Person ou PerformingGroup. Dans l'autre cas où ces informations sont connues, 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 Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Tableau des spécifications

TVSeries

TVEpisode

TVSeason

Spécifications de l'acteur

Utiliser les types Person ou PerformingGroup

Utiliser le type PerformanceRole

Noms de rôle acceptés

Différencier le rôle principal et le rôle secondaire d'un acteur

Exemples

Exemple de 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

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

Utiliser les types `Person` ou `PerformingGroup`

Utiliser le type `PerformanceRole`

Exemple de `TVSeries`, `TVEpisode` et `TVSeason`

Exemples de propriétés `Actor`