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 sur les propriétés de balisage de contenu pour les types d'entités TVSeries, TVEpisode et TVSeason.

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

Tableau des spécifications

TVSeries TVEpisode TVSeason

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : doit toujours être défini sur `["http://schema.org", {"@language": "xx"}]` "xx" représente la langue des chaînes du flux. La valeur @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/du doublage est l'anglais.
`@type`	Texte	Obligatoire : doit toujours être défini sur `TVSeries`.
`@id`	URL	Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit respecter les conditions suivantes : Unique dans l'ensemble de votre catalogue Cet identifiant doit être stable et ne pas changer au fil du temps (même si la propriété d'URL de l'émission change). Il sera traité comme une chaîne opaque et ne doit pas nécessairement s'agir d'un lien fonctionnel. Au format URI (Uniform Resource Identifier) 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 respecter les conditions 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 lister les noms dans différentes langues. Consultez l'exemple Plusieurs pays et langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle. Par exemple, le titreEIDR de la série télévisée "Game of Thrones" est "10.5240/C1B5-3BA1-8991-A571-8472-W".
`potentialAction`	WatchAction	Obligatoire si applicable : objet de balisage d'action qui fournit les détails de l'action. Si le contenu est disponible en vidéo à la demande (VOD), cette propriété est obligatoire. L'objet de balisage d'action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. L'entité `BroadcastService` associée fournit plutôt le lien profond de la chaîne. Un `TVSeries` peut être disponible à la fois sur la VOD et la TV en direct. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs pays 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). Il doit être distinct de la propriété `url`.
`inLanguage`	Texte	Langue d'origine de la série au format BCP 47.
`genre`	Texte	Liste triée de tous les genres pertinents. Par exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou balises 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 pour décrire 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 originale en salles d'un film. En outre, utilisez `FeaturedEvent` pour indiquer que votre service commercialise ce contenu en tant que contenu original, mis en avant, spécial, etc. `ExclusiveEvent` indique que votre service dispose de droits de distribution exclusifs et inclut l'endroit et la date. 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'un des éléments suivants : `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 des codes ISO 3166 pour les pays. Pour indiquer le monde entier, 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`, cette valeur indique la date de sortie initiale de l'entité, par exemple la date de sortie d'un film en salles. Pour `ExclusiveEvent` et `FeaturedEvent`, cette valeur indique la date de début de la période pendant laquelle l'entité est exclusive ou mise en avant.
`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 a présenté l'entité. Si le contenu est toujours exclusif ou présenté, 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 ? Un synopsis de l'émission Les synopsis de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum. Utilisez un tableau pour marquer la description dans plusieurs langues. Consultez l'exemple Plusieurs pays et langues.
`actor`	Person ou PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des membres de la distribution de la série. Pour obtenir des conseils sur la modélisation, cliquez ici.
`director`	Personne	Fortement recommandé Pourquoi ? Réalisateur(s) de l'émission.
`producer`	Organization ou Person	Fortement recommandé Pourquoi ? Producteur(s) de l'émission.
`image`	ImageObject	Obligatoire pour Google TV : images associées à la série télévisée. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez la section Propriétés des images.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple 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 ou les sources autorisées respectifs.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si cet attribut n'est pas spécifié, il est considéré comme autorisé 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 d'identifiant.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des 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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
`popularityScore.eligibleRegion`	Pays	Région(s) où ce score de popularité s'applique. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique à une zone géographique prévaut sur la popularité globale (EARTH)
`review`	Avis	Consulter les notes de la série TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni 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é pour les autres contenus : 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 est placée avant la note, avec un espace en-tre. 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 "CLASSIFICATION INCONNUE" (insensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Entreprise	Obligatoire si `contentRating` utilise `Rating` : nom de l'organisme de classification. Consultez la page Agences de classification du contenu pour obtenir la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la classification.
`contentRating.advisoryCode`	Texte	Code d'avertissement du contenu. Les valeurs acceptées sont : D, FV, L, S et V. D = Dialogue, FV = Violence fantastique, L = Langue, S = Contenu sexuel, V = Violence.

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : doit toujours être défini sur `["http://schema.org", {"@language": "xx"}]` "xx" représente la langue des chaînes du flux. La valeur @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/du doublage est l'anglais.
`@type`	Texte	Obligatoire : doit toujours être défini sur `TVEpisode`.
`@id`	URL	Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit respecter les conditions suivantes : Unique dans l'ensemble de votre catalogue Cet identifiant doit être stable et ne pas changer au fil du temps (même si la propriété d'URL de l'émission change). Il sera traité comme une chaîne opaque et ne doit pas nécessairement s'agir d'un lien fonctionnel. Au format URI (Uniform Resource Identifier) 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 respecter les conditions 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 lister les noms dans différentes langues. Consultez l'exemple Représentation dans plusieurs langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle. Par exemple, le titreEIDR 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 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 télévisée "Game of Thrones", dont l'ID 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 l'attribut editEIDR est fourni.
`inLanguage`	Texte	Langue d'origine de la série au format BCP 47.
`episodeNumber`	Entier	Obligatoire : numéro qui indique la position de cet épisode dans l'ordre des épisodes d'une saison. `episodeNumber` doit redémarrer pour chaque saison. Autrement dit, le premier épisode de chaque saison doit être 1.
`partOfSeason`	TVSeason	Obligatoire : saison de télévision à 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, procédez comme suit: 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, ?season1) pour créer un `partOfSeason.@id` unique (par exemple, http://www.example.com/my_favorite_tv_show?season1). Définissez `partOfSeason.seasonNumber` sur 1.
`partOfSeason.@type`	Texte	Obligatoire : doit toujours être défini sur `TVSeason`.
`partOfSeason.@id`	URL	Obligatoire : `@id` de l'`TVSeason` auquel cet épisode appartient.
`partOfSeason.seasonNumber`	Entier	Obligatoire : nombre indiquant la position de cette saison dans l'ordre des saisons de la série télévisée.
`partOfSeries`	TVSeries	Obligatoire : série TV à laquelle appartient cet épisode.
`partOfSeries.@type`	Texte	Obligatoire : doit toujours être défini sur `TVSeries`.
`partOfSeries.@id`	URL	Obligatoire : `@id` de l'`TVSeries` auquel cet épisode appartient.
`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). Il doit être distinct de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire si applicable : objet de balisage d'action qui fournit les détails de l'action. Si le contenu est disponible en vidéo à la demande (VOD), cette propriété est obligatoire. L'objet de balisage d'action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. L'entité `BroadcastService` associée fournit plutôt le lien profond de la chaîne. Un `TVEpisode` peut être disponible à la fois sur la VOD et la TV en direct. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs pays 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). Il doit être distinct 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 originale en salles d'un film. En outre, utilisez `FeaturedEvent` pour indiquer que votre service commercialise ce contenu en tant que contenu original, mis en avant, spécial, etc. `ExclusiveEvent` indique que votre service dispose de droits de distribution exclusifs et inclut l'endroit et la date. 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'un des éléments suivants : `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 des codes ISO 3166 pour les pays. Pour indiquer le monde entier, 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`, cette valeur indique la date de sortie initiale de l'entité, par exemple la date de sortie d'un film en salles. Pour `ExclusiveEvent` et `FeaturedEvent`, cette valeur indique la date de début de la période pendant laquelle l'entité est exclusive ou mise en avant.
`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 a présenté l'entité. Si le contenu est toujours exclusif ou présenté, 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 ? Résumé de l'épisode. Les synopsis de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum. Utilisez un tableau pour marquer la description dans plusieurs langues. Consultez l'exemple Représentation dans plusieurs langues.
`genre`	Texte	Liste triée de tous les genres pertinents. Par exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou balises 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 pour décrire le contenu.
`actor`	Person ou PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des membres de la distribution 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	Très recommandé Pourquoi ? pour Google TV : diverses images liées à l'épisode télévisé. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez la section Propriétés des images.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple 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 ou les sources autorisées respectifs.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si cet attribut n'est pas spécifié, il est considéré comme autorisé partout. Spécifiez les pays au format ISO 3166.
`review`	Avis	Consulter les classifications de l'épisode de la série TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni : 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é pour les autres contenus : 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 est placée avant la note, avec un espace en-tre. 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 "CLASSIFICATION INCONNUE" (insensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Entreprise	Obligatoire si `contentRating` utilise `Rating` : nom de l'organisme de classification. Consultez la page Agences de classification du contenu pour obtenir la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la classification.
`contentRating.advisoryCode`	Texte	Code d'avertissement du contenu. Les valeurs acceptées sont : D, FV, L, S et V. D = Dialogue, FV = Violence fantastique, L = Langue, S = Contenu 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 d'identifiant.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des 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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
`popularityScore.eligibleRegion`	Pays	Région(s) où ce score de popularité s'applique. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique à une zone géographique prévaut sur la popularité mondiale (EARTH)

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : doit toujours être défini sur `["http://schema.org", {"@language": "xx"}]` "xx" représente la langue des chaînes du flux. La valeur @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/du doublage est l'anglais.
`@type`	Texte	Obligatoire : doit toujours être défini sur `TVSeason`.
`@id`	URL	Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit respecter les conditions suivantes : Unique dans l'ensemble de votre catalogue Cet identifiant doit être stable et ne pas changer au fil du temps (même si la propriété d'URL de l'émission change). Il sera traité comme une chaîne opaque et ne doit pas nécessairement s'agir d'un lien fonctionnel. Au format URI (Uniform Resource Identifier) 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 respecter les conditions 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 la série TV. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Représentation dans plusieurs langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle. Par exemple, le titreEIDR de la première saison de la série TV intitulée "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 télévisée.
`partOfSeries`	TVSeries	Obligatoire : série TV à laquelle appartient cette saison.
`partOfSeries.@type`	Texte	Obligatoire : doit toujours être défini sur `TVSeries`.
`partOfSeries.@id`	URL	Obligatoire : `@id` de la `TVSeries` à laquelle cette saison appartient.
`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). Il doit être distinct de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire si applicable : objet de balisage d'action qui fournit les détails de l'action. Si le contenu est disponible en vidéo à la demande (VOD), cette propriété est obligatoire. L'objet de balisage d'action doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. L'entité `BroadcastService` associée fournit plutôt le lien profond de la chaîne. Un `TVSeason` peut être disponible à la fois sur la VOD et la TV en direct. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs pays 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). Il doit être distinct de la propriété `url`.
`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 originale en salles d'un film. En outre, utilisez `FeaturedEvent` pour indiquer que votre service commercialise ce contenu en tant que contenu original, mis en avant, spécial, etc. `ExclusiveEvent` indique que votre service dispose de droits de distribution exclusifs et inclut l'endroit et la date. Pour en savoir plus et voir des exemples, consultez la section d'exemples.
`releasedEvent.@type`	Texte	Obligatoire : veillez à toujours définir cette propriété sur l'un des éléments suivants : `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 des codes ISO 3166 pour les pays. Pour indiquer le monde entier, 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 l'entité, par exemple la date de sortie d'un film en salles. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de la période pendant laquelle l'entité est exclusive ou mise en avant.
`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 a présenté l'entité. Si le contenu est toujours exclusif ou présenté, 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 synopsis de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum. Utilisez un tableau pour marquer la description dans plusieurs langues. Consultez l'exemple Représentation dans plusieurs langues.
`actor`	[Person ou PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? Tableau des membres de la distribution 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 télévisée. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez la section Propriétés des images.
`genre`	Texte	Liste triée de tous les genres pertinents. Par exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou balises 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 pour décrire le contenu.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple 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 ou les sources autorisées respectifs.
`trailer.regionsAllowed`	Place	Régions dans lesquelles le contenu multimédia est autorisé. Si cet attribut n'est pas spécifié, il est considéré comme autorisé 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 d'identifiant.
`popularityScore`	PopularityScoreSpecification	Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des 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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
`popularityScore.eligibleRegion`	Pays	Région(s) où ce score de popularité s'applique. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité spécifique à une zone géographique prévaut sur la popularité globale (EARTH)
`review`	Avis	Consulter les notes de la saison TV
`review.reviewRating`	Note	Obligatoire si `review` est fourni 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é pour les autres contenus : 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 ajouté un espace avant la note. 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 "CLASSIFICATION INCONNUE" (insensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Entreprise	Obligatoire si `contentRating` utilise `Rating` : nom de l'organisme de classification. Consultez la page Agences de classification du contenu pour obtenir la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la classification.
`contentRating.advisoryCode`	Texte	Code d'avertissement du contenu. Les valeurs acceptées sont : D, FV, L, S et V. D = Dialogue, FV = Violence fantastique, L = Langue, S = Contenu sexuel, V = Violence.

Spécifications de l'acteur

La propriété actor des 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 télévisée. Les sections suivantes présentent la même chose, avec quelques exemples pour clarifier l'utilisation.

Propriété Type attendu Description

Propriété	Type attendu	Description
`actor`	Person ou PerformingGroup ou PerformanceRole	Fortement recommandé Pourquoi ? : Tableau des membres de la distribution. Utilisez le type PerformanceRole lorsque le rôle joué et (facultatif) le nom du personnage du ou des membres de la distribution sont connus. 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 PerformingGroup pour fournir des informations sur le ou les groupes/groupes musicaux lorsque le ou les rôles joués par le ou les membres de la distribution sont inconnus. Utilisez un tableau pour représenter plusieurs personnes, groupes d'artistes ou rôles de performance.

actor

Person ou PerformingGroup ou PerformanceRole

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

Utilisez le type PerformanceRole lorsque le rôle joué et (facultatif) le nom du personnage du ou des membres de la distribution sont connus. 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 PerformingGroup pour fournir des informations sur le ou les groupes/groupes musicaux lorsque le ou les rôles joués par le ou les membres de la distribution sont inconnus.

Utilisez un tableau pour représenter plusieurs personnes, groupes d'artistes ou rôles de performance.

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	Obligatoire : doit toujours être défini sur Person ou PerformingGroup.
`@id`	URL	Fortement recommandé Pourquoi ? - L'identifiant des acteurs ou du groupe d'artistes au format URI (par exemple, https://example.com/acteur/abc). `@id` doit répondre aux exigences suivantes: Unique dans l'ensemble de votre catalogue par acteur/groupe d'artistes Cet identifiant doit être stable et immuable dans le temps. Il sera traité comme une chaîne opaque et ne doit pas nécessairement s'agir d'un lien fonctionnel. Au format URI (Uniform Resource Identifier) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que l'`@id` utilisé dans la propriété "acteur" doit être utilisé de manière cohérente dans l'ensemble du flux. Par exemple, si deux films présentent le même acteur, la valeur `@id` doit être identique pour ces deux objets acteur.
`name`	Texte	Obligatoire : nom de l'acteur/de l'actrice/du membre de la distribution/du groupe artistique.
`sameAs`	URL	Fortement recommandé Pourquoi ? - URL d'une page Web de référence permettant d'identifier l'acteur ou le groupe d'artistes (par exemple, la page Wikipédia de l'acteur). Il doit être distinct 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 occupé par le membre de la distribution. Pour connaître la liste des valeurs acceptables, cliquez ici.
`characterName`	Texte	Nom d'un personnage interprété dans un rôle d'acteur ou de comédien. Ne définissez pas ce champ si le type d'acteur est PerformingGroup.
`actor`	Person ou PerformingGroup	Obligatoire : Nom du ou des acteurs du contenu lorsque le type de données Personne est utilisé. Nom du ou des groupes/groupes musicaux qui interprètent le contenu lorsque le type de données PerformingGroup est utilisé.
`actor.@type`	Person ou PerformingGroup	Obligatoire : doit toujours être défini sur Person ou PerformingGroup.
`actor.@id`	URL	Fortement recommandé Pourquoi ? - Identifiant de l'acteur ou du groupe d'artistes au format URI (par exemple, https://example.com/acteur/abc). `@id` doit répondre aux exigences suivantes: Unique dans l'ensemble de votre catalogue par acteur/groupe d'artistes Cet identifiant doit être stable et immuable dans le temps. Il sera traité comme une chaîne opaque et ne doit pas nécessairement s'agir d'un lien fonctionnel. Au format URI (Uniform Resource Identifier) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que l'`@id` utilisé dans la propriété "acteur" doit être utilisé de manière cohérente dans l'ensemble du flux. Par exemple, si deux films présentent le même acteur, la valeur `@id` doit être identique pour ces deux objets acteur.
`actor.name`	Texte	Obligatoire : nom de l'acteur/de l'actrice/du membre de la distribution/du groupe artistique.
`actor.sameAs`	URL	Fortement recommandé Pourquoi ? - URL d'une page Web de référence permettant d'identifier l'acteur ou le groupe d'artistes (par exemple, la page Wikipédia de l'acteur). Il doit être distinct de la propriété actor.@id.

Noms de rôle acceptés

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

Valeur `roleName`	Description
"Cameo"	Un rôle de caméo, également appelé "caméo", est une brève apparition d'une personne célèbre dans une œuvre des arts du spectacle.
"VoiceActor"	Une performance vocale consiste à utiliser la voix de l'acteur, mais sans qu'il n'apparaisse à l'écran. Cela se produit le plus souvent dans les animations, mais aussi lorsque la voix d'un acteur est doublée par celle d'un autre.
"Double"	Un double est une personne qui remplace un autre acteur de sorte que son visage ne soit pas visible.
"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 en animation 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 dans le média traditionnel du théâtre ou dans des médias modernes tels que le cinéma, la radio et la télévision.
"GuestStar"	"Un guest star est un acteur qui joue un rôle fictif et apparaît dans un ou plusieurs épisodes. Dans certains cas, une actrice ou un acteur invité peut jouer un personnage récurrent important et apparaître plusieurs fois dans une série, même s'il ne fait pas partie de la distribution principale. Définissez la valeur sur "GuestStar" lorsque l'acteur ou l'actrice apparaît dans un épisode en tant qu'invité. Les acteurs invités ne doivent être indiqués qu'au niveau de l'épisode et non au niveau de la série TV.
"Invité"	"Un invité dans une émission de talk-show. Notez que "GuestStar" est un rôle fictif, tandis que "Guest" est une apparition non fictive.
"Annonceur"	Un animateur est une personne qui prononce les accroches et les accroches de fin de l'émission, présente l'animateur, les candidats et/ou les invités célèbres, décrit les prix disponibles, prépare l'audience avant l'enregistrement et la divertit pendant les pauses.
"Commentateur"	Un commentateur commente un match ou un événement en temps réel, généralement lors d'une diffusion en direct.
"Impressionniste"	Un imitateur ou un imitateur de voix est un artiste dont le spectacle 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, présente ou anime des programmes télévisés, souvent en tant que médiateur entre le programme et l'audience. Le rôle d'animateur est généralement un rôle de non-fiction.
"CoHost"	Personne qui organise un événement/un programme conjointement avec une ou plusieurs autres personnes.
"GuestHost"	Un animateur invité est un animateur, généralement d'une émission de talk-show, qui anime le programme à la place de l'animateur habituel lorsqu'il n'est pas disponible.
"Journaliste"	Personne qui présente/informe le public sur les actualités et les événements à l'échelle locale, nationale et internationale via 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, des actualités radio ou télévisées, ou un autre type d'entreprise, depuis un lieu éloigné, souvent lointain.
"ShowJudge"	Un juge est une personne qui est souvent considérée comme un expert dans le domaine de l'émission. Il a pour rôle de critiquer les candidats qui passent des auditions et participent au concours de la série télévisée.
"Panéliste"	Membre d'un panel de discussion ou d'un panel consultatif d'une émission de radio ou de télévision.
"Participant"	Un participant à 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 fictif qui se produit régulièrement devant un public ou qui a enregistré des titres ou des albums musicaux. Les compositeurs et les paroliers ne doivent utiliser ce type que si les crédits de certaines œuvres musicales impliquent qu'ils contribuent également en tant qu'interprète principal. Ce type permet d'associer des musiciens ou groupes de musiciens permanents, ainsi que des musiciens ou groupes de musiciens invités, à des émissions.

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

Pour différencier les acteurs principaux/réguliers des acteurs invités/secondaires d'une série télévisée, ajoutez les acteurs principaux uniquement aux entités TVSeries et n'ajoutez que les acteurs invités ou les acteurs avec des rôles secondaires aux entités TVEpisode. Assurez-vous que la distribution principale/régulière n'est pas ajoutée aux entités TVEpisode.

Exemples

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

TVSeries TVEpisode TVSeason

{
  "@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"
     }
   ]
}

{
  "@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"
   }
}

{
  "@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`

Rôle de l'acteur inconnuRôle de l'acteur connuRôles connus pour un sous-ensemble d'acteurs

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"
    }
  ]

Lorsque le rôle d'un acteur est connu, nous vous recommandons de fournir les informations le concernant à 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"
      }
  }
]

Lorsque les métadonnées sur le rôle de l'artiste interprète ne sont pas connues, nous vous recommandons de fournir les informations sur l'acteur à l'aide du type Personne ou Groupe d'artistes . Dans le cas contraire, lorsque ces informations sont connues, utilisez le PerformanceRole . Vous pouvez ajouter ces types 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

Spécifications de l'acteur

Utiliser les types Person ou PerformingGroup

Utiliser le type PerformanceRole