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

Propriétés de balisage de contenu des séries TV

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

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

Table 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. Le contexte @language de chaque contexte racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être en espagnol, même si la langue du sous-titre est en anglais.
`@type`	Texte	Obligatoire : cette valeur est toujours définie sur `TVSeries`.
`@id`	URL	Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc. `@id` doit répondre aux exigences suivantes : Unique au niveau global dans votre catalogue L'ID doit être stable et immuable dans le temps (même si la propriété URL est modifiée). Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel. Sous la forme d'un 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`. Consultez la section Identifiant pour en savoir plus.
`url`	URL	Obligatoire : URL canonique du contenu, que Google utilise pour mettre en correspondance le contenu de votre flux avec les bases de données de Google. `url` doit respecter les exigences suivantes : `url` doit être unique `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour le lien profond de la lecture, consultez plutôt la propriété `urlTemplate` de l'objet cible.
`name`	Texte	Obligatoire : nom de la 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 pourquoi - Identifiant EIDR (Entertainment Identifier Registry) représentant, de manière générale ou abstraite, une œuvre cinématographique ou télévisée. Par exemple, le titreEIDR de la série TV Games of Thrones est "10.5240/C1B5-3BA1-8991-A571-8472-W".
`potentialAction`	WatchAction	Obligatoire, le cas échéant : objet de balisage d'action qui fournit les détails de l'action. Si le contenu est disponible dans la vidéo à la demande, cette propriété est obligatoire. L'objet de balisage "Action" doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne de télévision en direct, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne. Une `TVSeries` peut être disponible sur VoD et LiveTV. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
`sameAs`	URL	Fortement pourquoi URL vers une page Web de référence pouvant identifier l'émission (par exemple, sa page Wikipédia). Il doit être différent de la propriété `url`.
`inLanguage`	Texte	Langue d'origine de la série au format BCP 47.
`genre`	Texte	Liste numérotée de tous les genres pertinents. Exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés décrivant le contenu.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement pourquoi - Un élément `PublicationEvent` permet de spécifier la sortie d'un contenu original (mondial ou local) par un éditeur, comme la date de sortie initiale d'un film. Utilisez également `FeaturedEvent` pour indiquer que votre service présente ce contenu en tant que contenu original, spécial, spécial, etc. `ExclusiveEvent` spécifie que votre service dispose de droits de distribution exclusifs, et inclut où et quand. Consultez la section Exemple.
`releasedEvent.@type`	Texte	Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes : `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Country	Obligatoire : régions associées à cet événement. Pour une `PublicationEvent`, il s'agit de la région dans laquelle le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région dans laquelle le contenu est présenté ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer n'importe où dans le monde, définissez la valeur sur `EARTH`.
`releasedEvent.startDate`	Date ou DateTime	Recommandé : obligatoire pour `ExclusiveEvent` : date de début de la publication de l'entité. Pour un `PublicationEvent`, il s'agit de la date de sortie initiale de l'entité, telle que la date de sortie du film au cinéma. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de l'entité.
`releasedEvent.endDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : applicable uniquement aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date à laquelle les droits sur le contenu expirent. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur met en avant l'entité. Si le contenu est définitivement exclu ou sélectionné, définissez la valeur `endDate` sur 20 ans à compter de la date actuelle.
`releasedEvent.publishedBy`	Organisation ou Person	Facultatif : organisation ou personne qui a publié cette entité.
`description`	Texte	Fortement pourquoi Résumé de l'émission. Il est préférable d'utiliser des résumés de l'intrigue plutôt que des 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 pourquoi Tableau des membres de la série. Consultez ces consignes concernant la modélisation.
`director`	Personne	Fortement pourquoi Réalisateur du podcast.
`producer`	Organisation ou Person	Fortement pourquoi Le ou les producteurs de l'émission.
`image`	ImageObject	Obligatoire pour Google TV : images liées à la série TV. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés d'image.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple de la bande-annonce.
`trailer.inLanguage`	Texte	Langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL de la bande-annonce hébergée publiquement et mise en ligne par les studios de production ou les sources autorisées.
`trailer.regionsAllowed`	Établissement	Régions où le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, il est considéré comme autorisé partout. Spécifiez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement 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`	PopularitéScoreScore	Fortement 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 entre les flux de 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`	Country	Région(s) dans laquelle ce score de popularité s'applique. Si le niveau de popularité est valable dans le monde entier, définissez cette option sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité propre aux paramètres régionaux est prioritaire sur la popularité mondiale (EARTH)
`review`	Avis	Examiner les notes de la série TV
`review.reviewRating`	Rating	Obligatoire si `review` est fourni : permet de spécifier la note attribuée à l'avis.
`contentRating`	Texte ou Note	Obligatoire pour les contenus réservés aux adultes, fortement recommandé : classification globale du contenu. Si la classification du contenu est définie sous la forme d'une chaîne de texte, deux variantes sont acceptées: L'agence d'évaluation a ajouté un préfixe à la note, avec un espace blanc entre les deux. Par exemple, la classification "TV-PG" de l'agence "TVPG" aux États-Unis doit être définie sur "TV-TV-MA". Consultez la liste des agences. La valeur "RATING NOT KNOWN" (non sensible à la casse) indique que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Texte ou Organisation	Obligatoire si `contentRating` utilise `Rating` : nom de l'organisme d'évaluation. Consultez la page Agences de classification de contenu pour obtenir la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la note.
`contentRating.advisoryCode`	Texte	Code consultatif du contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.

TVEpisode

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire – Toujours défini sur `["http://schema.org", {"@language": "xx"}]` Où"xx" représente la langue des chaînes dans le flux. Le contexte @language de chaque contexte racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être en espagnol, même si la langue du sous-titre est en anglais.
`@type`	Texte	Obligatoire : cette valeur est toujours définie sur `TVEpisode`.
`@id`	URL	Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc. `@id` doit répondre aux exigences suivantes : Unique au niveau global dans votre catalogue L'ID doit être stable et immuable dans le temps (même si la propriété URL est modifiée). Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel. Sous la forme d'un 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`. Consultez la section Identifiant pour en savoir plus.
`url`	URL	Obligatoire : URL canonique du contenu, que Google utilise pour mettre en correspondance le contenu de votre flux avec les bases de données de Google. `url` doit respecter les exigences suivantes : `url` doit être unique `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour le lien profond de la lecture, consultez plutôt la propriété `urlTemplate` de l'objet cible.
`name`	Texte	Obligatoire : nom de l'épisode. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Représentation multilingue. Notez qu'un seul nom est accepté par paramètre régional (paire langue/pays).
`titleEIDR`	Texte	Fortement pourquoi - Identifiant EIDR (Entertainment Identifier Registry) représentant, de manière générale ou abstraite, une œuvre cinématographique ou télévisée. Par exemple, le titreEIDR du premier épisode de la première saison de "TVSeries" appelé "Game of Thrones" est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Texte	Fortement pourquoi - Identifiant EIDR (Entertainment Identifier Registry) représentant le montage ou l'édition d'un film ou d'une série TV. Par exemple, le premier épisode de la première saison d'une série télévisée connu sous le nom de "Game of Thrones", dont le titre est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", comporte une modification, par exemple "10.5240/FB97-C847-2969-D0AB-D0C". La propriété `titleEIDR` est obligatoire lorsque l'élément EditEIDR est fourni.
`inLanguage`	Texte	Langue d'origine de la série au format BCP 47.
`episodeNumber`	Entier	Obligatoire : nombre indiquant la position de cet épisode dans l'ordre des épisodes de la saison. `episodeNumber` doit redémarrer pour chaque saison. Autrement dit, le premier épisode de chaque saison doit être égal à 1.
`partOfSeason`	Saison de série TV	Obligatoire : saison de série TV à laquelle cet épisode appartient. Même si un `TVEpisode` ne possède pas de `TVSeason` correspondant, vous devez tout de même fournir les propriétés `partOfSeason.@id` et `partOfSeason.seasonNumber`. Solution de contournement: 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, ?series1) pour créer un `partOfSeason.@id` unique (par exemple, http://www.example.com/my_favorite_tv_show?series1). Définissez `partOfSeason.seasonNumber` sur 1.
`partOfSeason.@type`	Texte	Obligatoire : cette valeur est toujours définie sur `TVSeason`.
`partOfSeason.@id`	URL	Obligatoire – `@id` de la `TVSeason` à laquelle 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`	Série TV	Obligatoire : série TV à laquelle appartient cet épisode.
`partOfSeries.@type`	Texte	Obligatoire : cette valeur est toujours définie sur `TVSeries`.
`partOfSeries.@id`	URL	Obligatoire – `@id` de la `TVSeries` à laquelle appartient cet épisode.
`partOfSeries.name`	Texte	Obligatoire : nom de la série TV.
`partOfSeries.sameAs`	Texte	URL vers une page Web de référence pouvant identifier l'émission (par exemple, sa page Wikipédia). Il doit être différent de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire, le cas échéant : objet de balisage d'action qui fournit les détails de l'action. Si le contenu est disponible dans la vidéo à la demande, cette propriété est obligatoire. L'objet de balisage "Action" doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne de télévision en direct, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne. Une `TVEpisode` peut être disponible sur VoD et LiveTV. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
`sameAs`	Fortement pourquoi URL	URL d'une page Web de référence pouvant identifier l'épisode. Par exemple, page Wikipédia de l'épisode. Il doit être différent de la propriété `url`.
`duration`	Durée	Durée de l'épisode au format ISO 8601. Veuillez utiliser le format suivant: "PT00H00M".
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement pourquoi - Un élément `PublicationEvent` permet de spécifier la sortie d'un contenu original (mondial ou local) par un éditeur, comme la date de sortie initiale d'un film. Utilisez également `FeaturedEvent` pour indiquer que votre service présente ce contenu en tant que contenu original, spécial, spécial, etc. `ExclusiveEvent` spécifie que votre service dispose de droits de distribution exclusifs, et inclut où et quand. Consultez la section Exemple.
`releasedEvent.@type`	Texte	Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes : `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Country	Obligatoire : régions associées à cet événement. Pour une `PublicationEvent`, il s'agit de la région dans laquelle le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région dans laquelle le contenu est présenté ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer n'importe où dans le monde, définissez la valeur sur `EARTH`.
`releasedEvent.startDate`	Date ou DateTime	Recommandé : obligatoire pour `ExclusiveEvent` : date de début de la publication de l'entité. Pour un `PublicationEvent`, il s'agit de la date de sortie initiale de l'entité, telle que la date de sortie du film au cinéma. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de l'entité.
`releasedEvent.endDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : applicable uniquement aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date à laquelle les droits sur le contenu expirent. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur met en avant l'entité. Si le contenu est définitivement exclu ou sélectionné, définissez la valeur `endDate` sur 20 ans à compter de la date actuelle.
`releasedEvent.publishedBy`	Organisation ou Person	Facultatif : organisation ou personne qui a publié cette entité.
`description`	Texte	Fortement pourquoi Résumé de l'épisode. Il est préférable d'utiliser des résumés de l'intrigue plutôt que des résumés factuels. 300 caractères maximum. Utilisez un tableau pour baliser la description dans plusieurs langues. Consultez l'exemple Représentation multilingue.
`genre`	Texte	Liste numérotée de tous les genres pertinents. Exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés décrivant le contenu.
`actor`	Person, PerformingGroup ou PerformanceRole	Fortement pourquoi Tableau des acteurs de l'épisode. Consultez ces consignes concernant la modélisation.
`director`	Personne	Fortement pourquoi Directeur(s) de l'épisode.
`producer`	Organisation ou Person	Fortement pourquoi Le ou les producteurs de la saison.
`image`	ImageObject	Recommandé pour Google TV : différentes images en lien avec l'épisode TV (fortement recommandé). Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés d'image.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple de la bande-annonce.
`trailer.inLanguage`	Texte	Langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL de la bande-annonce hébergée publiquement et mise en ligne par les studios de production ou les sources autorisées.
`trailer.regionsAllowed`	Établissement	Régions où le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, il est considéré comme autorisé partout. Spécifiez les pays au format ISO 3166.
`review`	Avis	Examiner les notes de l'épisode de série TV
`review.reviewRating`	Rating	Obligatoire si `review` est fourni : permet de spécifier la note attribuée à l'avis.
`contentRating`	Texte ou Note	Obligatoire pour les contenus réservés aux adultes, fortement recommandé : classification globale du contenu. Si la classification du contenu est définie sous la forme d'une chaîne de texte, deux variantes sont acceptées: L'agence d'évaluation a ajouté un préfixe à la note, avec un espace blanc entre les deux. Par exemple, la classification "TV-PG" de l'agence "TVPG" aux États-Unis doit être définie sur "TV-TV-MA". Consultez la liste des agences. La valeur "RATING NOT KNOWN" (non sensible à la casse) indique que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Texte ou Organisation	Obligatoire si `contentRating` utilise `Rating` : nom de l'organisme d'évaluation. Consultez la page Agences de classification de contenu pour obtenir la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la note.
`contentRating.advisoryCode`	Texte	Code consultatif du contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.
`identifier`	PropertyValue	Fortement 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`	PopularitéScoreScore	Fortement 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 entre les flux de 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`	Country	Région(s) dans laquelle ce score de popularité s'applique. Si le niveau de popularité est valable dans le monde entier, définissez cette option sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité propre aux paramètres régionaux est prioritaire sur la popularité mondiale (EARTH)

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. Le contexte @language de chaque contexte racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être en espagnol, même si la langue du sous-titre est en anglais.
`@type`	Texte	Obligatoire : cette valeur est toujours définie sur `TVSeason`.
`@id`	URL	Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc. `@id` doit répondre aux exigences suivantes : Unique au niveau global dans votre catalogue L'ID doit être stable et immuable dans le temps (même si la propriété URL est modifiée). Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel. Sous la forme d'un 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`. Consultez la section Identifiant pour en savoir plus.
`url`	URL	Obligatoire : URL canonique du contenu, que Google utilise pour mettre en correspondance le contenu de votre flux avec les bases de données de Google. `url` doit respecter les exigences suivantes : `url` doit être unique `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour le lien profond de la lecture, consultez plutôt la propriété `urlTemplate` de l'objet cible.
`name`	Texte	Obligatoire : nom de la saison de série TV. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Représentation multilingue. Notez qu'un seul nom est accepté par paramètre régional (paire langue/pays).
`titleEIDR`	Texte	Fortement pourquoi - Identifiant EIDR (Entertainment Identifier Registry) représentant, de manière générale ou abstraite, une œuvre cinématographique ou télévisée. Par exemple, le titreEIDR de la première saison de "TVSeries" appelé "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`	Série TV	Obligatoire : série TV à laquelle appartient cette saison.
`partOfSeries.@type`	Texte	Obligatoire : cette valeur est toujours définie sur `TVSeries`.
`partOfSeries.@id`	URL	Obligatoire – `@id` de la `TVSeries` à laquelle cette saison fait partie.
`partOfSeries.name`	Texte	Obligatoire : nom de la série TV.
`partOfSeries.sameAs`	Texte	URL vers une page Web de référence pouvant identifier l'émission (par exemple, sa page Wikipédia). Il doit être différent de la propriété `url`.
`potentialAction`	WatchAction	Obligatoire, le cas échéant : objet de balisage d'action qui fournit les détails de l'action. Si le contenu est disponible dans la vidéo à la demande, cette propriété est obligatoire. L'objet de balisage "Action" doit fournir le lien profond du contenu. Si le contenu est disponible sur une chaîne de télévision en direct, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne. Une `TVSeason` peut être disponible sur VoD et LiveTV. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
`sameAs`	URL	Fortement pourquoi URL d'une page Web de référence pouvant identifier la saison (par exemple, la page Wikipédia de la saison). Il doit être différent de la propriété `url`.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement pourquoi - Un élément `PublicationEvent` permet de spécifier la sortie d'un film original (dans le monde entier ou en magasin), par exemple la date de sortie initiale d'un film. Utilisez également `FeaturedEvent` pour indiquer que votre service présente ce contenu en tant que contenu original, mis en avant, spécial, etc. `ExclusiveEvent` spécifie que votre service dispose de droits de distribution exclusifs, et précise où et quand. Voir la section et des exemples.
`releasedEvent.@type`	Texte	Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes : `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Country	Obligatoire : régions associées à cet événement. Pour une `PublicationEvent`, il s'agit de la région dans laquelle le contenu a été publié. Pour `FeaturedEvent` et `ExclusiveEvent`, il s'agit de la région dans laquelle le contenu est présenté ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer n'importe où dans le monde, définissez la valeur sur `EARTH`.
`releasedEvent.startDate`	Date ou DateTime	Recommandé : obligatoire pour `ExclusiveEvent` : date de début de la publication de l'entité. Pour un `PublicationEvent`, il s'agit de la date de sortie initiale de l'entité, telle que la date de sortie du film au cinéma. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de l'entité.
`releasedEvent.endDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : applicable uniquement aux types `ExclusiveEvent` et `FeaturedEvent`. Pour `ExclusiveEvent`, il s'agit de la date à laquelle les droits sur le contenu expirent. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur met en avant l'entité. Si le contenu est définitivement exclu ou sélectionné, définissez la valeur `endDate` sur 20 ans à compter de la date actuelle.
`releasedEvent.publishedBy`	Organisation ou Person	Facultatif : organisation ou personne qui a publié cette entité.
`description`	Texte	Fortement pourquoi Résumé de la saison. Il est préférable d'utiliser des résumés de l'intrigue plutôt que des résumés factuels. 300 caractères maximum. Utilisez un tableau pour baliser la description dans plusieurs langues. Consultez l'exemple Représentation multilingue.
`actor`	[Personne, PerformingGroup ou PerformanceRole	Fortement pourquoi Tableau des acteurs de la saison. Consultez ces consignes concernant la modélisation.
`director`	Personne	Fortement pourquoi Tableau des réalisateurs de l'émission.
`producer`	Organisation ou Person	Fortement pourquoi Le ou les producteurs de la saison.
`image`	ImageObject	Images liées à la saison de série TV. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez Propriétés d'image.
`genre`	Texte	Liste numérotée de tous les genres pertinents. Exemple : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Texte	Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés décrivant le contenu.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple de la bande-annonce.
`trailer.inLanguage`	Texte	Langue de la bande-annonce au format BCP 47.
`trailer.url`	URL	URL de la bande-annonce hébergée publiquement et mise en ligne par les studios de production ou les sources autorisées.
`trailer.regionsAllowed`	Établissement	Régions où le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, il est considéré comme autorisé partout. Spécifiez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement 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`	PopularitéScoreScore	Fortement 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 entre les flux de 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`	Country	Région(s) dans laquelle ce score de popularité s'applique. Si le niveau de popularité est valable dans le monde entier, définissez cette option sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité propre aux paramètres régionaux est prioritaire sur la popularité mondiale (EARTH)
`review`	Avis	Examiner les notes de la saison de série TV
`review.reviewRating`	Rating	Obligatoire si `review` est fourni : permet de spécifier la note attribuée à l'avis.
`contentRating`	Texte ou Note	Obligatoire pour les contenus réservés aux adultes, fortement recommandé : classification globale du contenu. Si la classification du contenu est définie sous la forme d'une chaîne de texte, deux variantes sont acceptées: L'agence d'évaluation a ajouté un préfixe à la note, avec un espace blanc entre les deux. Par exemple, la classification "TV-PG" de l'agence "TVPG" aux États-Unis doit être définie sur "TV-TV-MA". Consultez la liste des agences. La valeur "RATING NOT KNOWN" (non sensible à la casse) indique que vous ne connaissez pas la classification du contenu.
`contentRating.author`	Texte ou Organisation	Obligatoire si `contentRating` utilise `Rating` : nom de l'organisme d'évaluation. Consultez la page Agences de classification de contenu pour obtenir la liste des agences de classification acceptées.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la note.
`contentRating.advisoryCode`	Texte	Code consultatif du contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.

Caractéristiques de l'utilisateur

La propriété actor dans les types d'entités TVSeries, TVEpisode et TVSeason vous permet de spécifier plus de détails sur les acteurs, y compris le nom de leurs personnages et leurs rôles dans l'émission télévisée. La ou les sections suivantes capturent la même chose, avec quelques exemples expliquant l'utilisation.

Propriété Type attendu Description

Propriété	Type attendu	Description
`actor`	Person, PerformingGroup ou PerformanceRole	Fortement pourquoi : tableau des membres de la distribution Utilisez le type PerformanceRole lorsque le rôle est joué et (éventuellement) le nom du ou des membres de la distribution. Dans ce cas, l'acteur Person ou PerformingGroup est intégré à l'objet PerformanceRole. Utilisez le type Person pour indiquer les acteurs individuels ou PerformingGroup pour fournir les détails des groupes/bandes de performance lorsque les rôles des membres de la distribution sont inconnus. Utilisez un tableau pour représenter plusieurs personnes, PerformingGroups ou PerformanceRoles.

actor

Person, PerformingGroup ou PerformanceRole

Fortement pourquoi : tableau des membres de la distribution

Utilisez le type PerformanceRole lorsque le rôle est joué et (éventuellement) le nom du ou des membres de la distribution. Dans ce cas, l'acteur Person ou PerformingGroup est intégré à l'objet PerformanceRole.
Utilisez le type Person pour indiquer les acteurs individuels ou PerformingGroup pour fournir les détails des groupes/bandes de performance lorsque les rôles des membres de la distribution sont inconnus.

Utilisez un tableau pour représenter plusieurs personnes, PerformingGroups ou PerformanceRoles.

Avec 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 pourquoi - Acteurs ou identifiant de groupe sous forme d'URI, par exemple https://example.com/actor/abc `@id` doit répondre aux exigences suivantes: Unique au niveau mondial de votre catalogue par acteur/groupe de performance Cet identifiant doit être stable et immuable dans le temps. Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel. Sous la forme d'un URI (Uniform Resource Identifier) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que le `@id` utilisé dans la propriété de l'acteur doit être utilisé de manière cohérente dans le flux. Par exemple, si deux films présentent le même acteur, la valeur `@id` doit être identique sur les deux objets "acteur".
`name`	Texte	Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe de spectacle.
`sameAs`	URL	Fortement pourquoi - URL d'une page Web de référence pouvant identifier l'acteur ou le groupe de spectacle (par exemple, sa page Wikipédia). Il doit être différent de la propriété `@id`.

En utilisant le type `PerformanceRole`

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

Propriété	Type attendu	Description
`@type`	Rôle de performance	Obligatoire : Toujours définir sur PerformanceRole
`roleName`	Texte	Fortement pourquoi - Rôle joué, interprété ou rempli par le membre de la diffusion. Pour consulter la liste des valeurs acceptées, cliquez ici.
`characterName`	Texte	Nom d'un personnage incarné ou jouer un rôle Ne définissez pas ce champ si le type d'acteur est PerformingGroup.
`actor`	Person ou PerformingGroup	Obligatoire : Membres du casting du contenu lorsque le type de données Person est utilisé Groupe(s) de performances des contenus 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 pourquoi - Utilisateur ou identifiant de groupe au format URI (par exemple, https://example.com/actor/abc) `@id` doit répondre aux exigences suivantes: Unique au niveau mondial de votre catalogue par acteur/groupe de performance Cet identifiant doit être stable et immuable dans le temps. Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel. Sous la forme d'un URI (Uniform Resource Identifier) Votre organisation doit être propriétaire du domaine utilisé pour la valeur `@id`. Notez que le `@id` utilisé dans la propriété de l'acteur doit être utilisé de manière cohérente dans le flux. Par exemple, si deux films présentent le même acteur, la valeur `@id` doit être identique sur les deux objets "acteur".
`actor.name`	Texte	Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe de spectacle.
`actor.sameAs`	URL	Fortement pourquoi - URL d'une page Web de référence pouvant identifier l'acteur ou le groupe de spectacle (par exemple, sa page Wikipédia). Il doit être différent de la propriété "actor.@id".

Noms de rôle acceptés

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

Valeur `roleName`	Description
"Cameo"	Le rôle de camouflage est une brève apparition d'une personne célèbre dans une œuvre d'arts du spectacle.
"Acteur"	On parle de performance vocale dans laquelle la voix de l'acteur est utilisée, mais pas à l'écran. Ce phénomène se produit généralement dans l'animation, mais aussi lorsque la voix d'un acteur est doublée au niveau de la voix de l'autre acteur.
"Double"	Un double est une personne qui remplace un autre acteur afin que son visage ne soit pas visible.
"MotionCaptureActor"	Un MotionCaptureActor désigne une personne qui enregistre des actions d'acteurs humains qui utilise ces informations pour animer des modèles de personnages numériques en 2D ou en 3D.

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

Valeur `roleName`	Description
"Acteur"	Un acteur ou actrice est une personne qui joue un personnage dans une pièce de théâtre traditionnelle sur le théâtre ou dans un média moderne tel que le cinéma, la radio et la télévision.
« InvitéStar »	"Un invité acteur est un acteur qui joue un rôle fictif dans un ou plusieurs épisodes. Dans certains cas, une star de la scène invité peut jouer un personnage récurrent important et apparaître plusieurs fois dans une série, alors qu'elle n'est pas membre de la distribution principale. Définissez la valeur sur "Invité" lorsque l'acteur accueille un concert ou est un invité de l'émission. Les invités ne doivent être ajoutés qu'au niveau de l'épisode et ne doivent pas être ajoutés au niveau de la série TV.
"Invité"	"Invitée dans un talk-show. Remarque : bien que le rôle de invité ne soit pas fictif, l'élément"Invité" n'est pas fictif.
" commentateur"	Un présentateur est une personne qui joue des piliers d'ouverture et de fermeture pour le spectacle, présente l'animateur, les participants et/ou les invités célèbres. Il décrit les prix disponibles et prépare le public avant l'enregistrement et les divertit pendant les pauses.
"Commentateur"	Un commentateur fournit des commentaires en temps réel sur un jeu ou un événement, généralement pendant une diffusion en direct.
"Impressionniste"	Un impressionniste est un acteur qui imite des sons, des voix et des mimements de célébrités et de personnages de dessin animé.
"Hôte"	Personne qui présente, présente ou héberge des programmes télévisés, et joue souvent le rôle de médiateur de l'émission et du public. L'"hôte" est généralement un rôle de non-fiction.
"Coorganisateur"	Personne qui organise un événement ou un programme avec une ou plusieurs autres personnes.
"HostHost"	Un hôte est un présentateur, généralement un talk-show, qui organise le programme à la place de l'hôte standard lorsqu'il n'est pas disponible.
"Newscaster"	Personne qui présente/informe le public des actualités et des événements organisés à l'échelle locale, nationale et internationale via un programme télévisé.
"Correspondant"	Un correspondant ou journaliste sur scène est généralement un journaliste ou un commentateur d'un magazine, ou un agent qui contribue à des reportages dans un journal, la presse radio ou télévisuelle, ou un autre type d'entreprise, depuis un lieu distant, souvent distant.
"Montre-moi un juge"	Un juge est une personne souvent considérée comme une experte dans le domaine du spectacle. Il joue le rôle de "déclaration" contre les candidats qui auditionnent pour la série télévisée et y participent.
"Panel"	Membre d'une discussion ou d'un panel consultatif d'une équipe de radio ou de télévision
"Concurrent"	Un participant à un concours ou à un jeu télévisé est une personne qui y participe.
"Narrateur de récit"	Le narrateur est la personne qui raconte un événement, en particulier un personnage qui retrace les événements d'un roman
"Artiste musical"	"Un artiste musical peut être une personne, un groupe ou un personnage fictif qui se joue généralement devant un public régulièrement 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 de certaines œuvres musicales sous-entendent qu'ils contribuent également à l'interprétation principale. Ce type peut être utilisé pour associer des groupes de musiciens ou des groupes de musiciens permanents, et des musiciens ou groupes de musiciens invités.

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

Pour différencier les acteurs principaux/habituels et les invités/accompagnateurs d'une série TV, ajoutez uniquement la distribution principale sur les entités TVSeries et n'ajoutez que les acteurs ou les invités invités avec des rôles associés sur les entités TVEpisode. Assurez-vous que la diffusion principale/standard n'est pas ajoutée aux entités TVEpisode.

Exemples

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

`Actor` exemple de propriété

Le rôle de l'acteur est inconnu

Lorsque le rôle d'un acteur est inconnu, nous recommandons simplement de lui fournir ses informations à l'aide du type Person ou PerformingGroup .

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

Le rôle de l'acteur est connu

Lorsque le rôle d'un acteur est connu, nous recommandons de lui fournir ses informations à 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 des rôles sur les performances ne sont pas connues, nous vous recommandons de fournir des informations sur l'acteur à l'aide du type Personne ou PerformingGroup. Dans l'autre cas où cette information est connue, utilisez le type PerformanceRole . Ces types peuvent être ajoutés ensemble dans le même tableau.

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

Propriétés de balisage de contenu des séries TV

Table des spécifications

TVSeries

TVEpisode

TVSeason

Caractéristiques de l'utilisateur

Avec les types Person ou PerformingGroup

En utilisant le type PerformanceRole

Noms de rôle acceptés

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

Exemples

Exemples TVSeries, TVEpisode et TVSeason

TVSeries

TVEpisode

TVSeason

Actor exemple de propriété

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

Avec les types `Person` ou `PerformingGroup`

En utilisant le type `PerformanceRole`

Exemples `TVSeries`, `TVEpisode` et `TVSeason`

`Actor` exemple de propriété