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

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

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

Tableau des spécifications

TVSeries

Propriété Type attendu Description
@context Texte Obligatoire : toujours défini sur ["http://schema.org", {"@language": "xx"}]
  • Où ?" xx pouces représente la langue des chaînes du flux. La balise @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres est l'anglais.
@type Texte Obligatoire : toujours défini sur TVSeries.
@id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
@id doit remplir les conditions suivantes:
  • Unique au niveau mondial dans votre catalogue
  • L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un identifiant de ressource unifié (URI)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit respecter les exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
Pour le lien profond de la lecture, consultez plutôt la propriété urlTemplate de l'objet cible.
name Texte Obligatoire : nom de l'émission.
  • Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
  • Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? : identifiant EIDR (Entertainment Identifier Registry) représentant au niveau le plus général/abstrait d'une œuvre de film ou de télévision.

Exemple : titre EIDR pour la série "Game of Thrones" est "10.5240/C1B5-3BA1-8991-A571-8472-W".
potentialAction WatchAction Obligatoire, le cas échéant : un objet de balisage Action qui fournit les détails de l'action.
  • Si le contenu est disponible pour la vidéo à la demande (VoD), cette propriété est obligatoire. L'objet de balisage Action doit fournir le lien profond du contenu.
  • Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. À la place, l'entité BroadcastService associée fournit le lien profond du canal.
  • Un TVSeries peut être disponible à la fois sur VoD et LiveTV.
Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
sameAs URL Fortement recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier l'émission. par exemple, la page Wikipédia de l'émission. Elle doit être distincte de la propriété url.
inLanguage Texte Langue d'origine de la série au format BCP 47.
genre Texte Liste numérotée de tous les genres pertinents. Par exemple : ["Action", "Fashion", "Environment", "Football"]
keywords Texte Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés permettant de décrire le contenu.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - Un PublicationEvent permet d'indiquer la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme sa date de sortie en salle.

Vous pouvez également utiliser FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, sélectionné, spécial, etc.

ExclusiveEvent indique que votre service dispose de droits de distribution exclusifs, et inclut où et quand.

Consultez la section Exemples pour obtenir des détails et des exemples.
releasedEvent.@type Texte Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : régions associées à cet événement.

Pour une PublicationEvent, il s'agit de la région dans laquelle le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est présenté ou exclusif.

Utilisez les codes ISO 3166 pour les pays. Pour indiquer partout dans le monde, définissez la valeur sur EARTH.
releasedEvent.startDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : date de début de la publication de l'entité.

Pour PublicationEvent, il s'agit de la date de sortie initiale de cette entité, par exemple la date de la première sortie du film en salle.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début à laquelle l'entité est mise en avant ou exclusive.
releasedEvent.endDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : s'applique uniquement aux types ExclusiveEvent et FeaturedEvent.

Pour ExclusiveEvent, il s'agit de la date d'expiration des droits du contenu.

Pour FeaturedEvent, il s'agit de la dernière date à laquelle le fournisseur présente l'entité.

Si le contenu est exclusif ou mis en avant en permanence, définissez endDate sur 20 ans à compter de la date du jour.
releasedEvent.publishedBy Organisation ou personne Facultatif. Organisation ou personne ayant publié cette entité.
description Texte Fortement recommandé Pourquoi ? Un résumé de l'émission. Les résumés de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum.
actor Person, PerformingGroup ou PerformanceRole Fortement recommandé Pourquoi ? Tableau des acteurs de la série. Pour obtenir des conseils de modélisation, cliquez ici.
director Personne Fortement recommandé Pourquoi ? Le ou les réalisateurs de l'émission.
producer Organisation ou personne Fortement recommandé Pourquoi ? Producteur(s) de l'émission.
image ImageObject Obligatoire pour Google TV : images associées aux séries TV. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez Propriétés de l'image.
trailer.description Texte Description de la bande-annonce. Consultez l'exemple de bande-annonce.
trailer.inLanguage Texte Langue de la bande-annonce au format BCP 47.
trailer.url URL URL d'une bande-annonce hébergée publiquement et mise en ligne par les studios de production respectifs ou des sources autorisées.
trailer.regionsAllowed Place Régions dans lesquelles le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
identifier PropertyValue Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau de popularité d'une entité est défini sur 0.
popularityScore.@type Texte Toujours défini sur PopularityScoreSpecification.
popularityScore.value Number Valeur numérique non négative indiquant la popularité de l'entité. un score élevé signifie une popularité plus élevée.
popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).
review Avis Consulter les avis sur la série TV
review.reviewRating Note Obligatoire si review est fourni Cette valeur permet de spécifier la note attribuée à l'avis.
contentRating Text ou Rating Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas : classification globale du contenu. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées:
  • L'agence de notation a été ajoutée avant la note par un espace blanc. Par exemple, "TV-MA" note de l'agence "TVPG" aux États-Unis doit être désigné par la mention "TVPG TV-MA". Consultez la liste des agences.
  • La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'agence de classification. Consultez la page Agences de classification de contenu pour consulter la liste des agences de classification acceptées.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.

TVEpisode

Propriété Type attendu Description
@context Texte Obligatoire : toujours défini sur ["http://schema.org", {"@language": "xx"}]
  • Où ?" xx pouces représente la langue des chaînes du flux. La balise @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres est l'anglais.
@type Texte Obligatoire : toujours défini sur TVEpisode.
@id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
@id doit remplir les conditions suivantes:
  • Unique au niveau mondial dans votre catalogue
  • L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un identifiant de ressource unifié (URI)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit respecter les exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
Pour le lien profond de la lecture, consultez plutôt la propriété urlTemplate de l'objet cible.
name Texte Obligatoire : nom de l'épisode.
  • Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Représentation dans plusieurs langages.
  • Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? : identifiant EIDR (Entertainment Identifier Registry) représentant au niveau le plus général/abstrait d'une œuvre de film ou de télévision.

Exemple : titre EIDR du premier épisode de la première saison de l'émission télévisée "Game of Thrones" est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR Texte Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant le montage / l'édition d'une œuvre d'un film ou d'une émission télévisée.

Par exemple, le premier épisode de la première saison de l'émission télévisée "Game of Thrones", dont le titre EIDR est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", comporte un montage (ex. : "10.5240/FB97-C847-2969-D0AB-ECD1-C".

La propriété titleEIDR est obligatoire lorsque le montage EIDR est fourni.
inLanguage Texte Langue d'origine de la série au format BCP 47.
episodeNumber Entier Obligatoire : numéro indiquant la position de l'épisode dans l'ordre des épisodes d'une saison. episodeNumber doivent redémarrer pour chaque saison ; Autrement dit, le premier épisode de chaque saison doit être 1.
partOfSeason TVSeason Obligatoire : saison de série TV à laquelle appartient cet épisode.

Même si une TVEpisode n'a pas de TVSeason correspondante, vous devez quand même fournir les propriétés partOfSeason.@id et partOfSeason.seasonNumber. Voici une solution:
  • Prenez partofSeries.@id (par exemple, http://www.example.com/my_favorite_tv_show) et joignez un champ de requête d'espace réservé (par exemple, http://www.example.com/my_favorite_tv_show) pour créer une partOfSeason.@id unique (par exemple, http://www.example.com/my_favorite_tv_show).
  • Définissez partOfSeason.seasonNumber sur 1.
partOfSeason.@type Texte Obligatoire : toujours défini sur TVSeason.
partOfSeason.@id URL Obligatoire : @id de la propriété TVSeason dont cet épisode fait partie.
partOfSeason.seasonNumber Entier Obligatoire : numéro indiquant la position de la saison dans l'ordre des saisons de la série TV.
partOfSeries TVSeries Obligatoire : série TV à laquelle appartient cet épisode.
partOfSeries.@type Texte Obligatoire : toujours défini sur TVSeries.
partOfSeries.@id URL Obligatoire : @id de la propriété TVSeries dont cet épisode fait partie.
partOfSeries.name Texte Obligatoire : nom de la série TV.
partOfSeries.sameAs Texte URL d'une page Web de référence permettant d'identifier l'émission. par exemple, la page Wikipédia de l'émission. Elle doit être distincte de la propriété url.
potentialAction WatchAction Obligatoire, le cas échéant : un objet de balisage Action qui fournit les détails de l'action.
  • Si le contenu est disponible pour la vidéo à la demande (VoD), cette propriété est obligatoire. L'objet de balisage Action doit fournir le lien profond du contenu.
  • Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. À la place, l'entité BroadcastService associée fournit le lien profond du canal.
  • Un TVEpisode peut être disponible à la fois sur VoD et LiveTV.
Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
sameAs Fortement recommandé Pourquoi ? URL URL d'une page Web de référence pouvant identifier l'épisode. par exemple, la page Wikipédia de l'épisode. Elle doit être distincte de la propriété url.
duration Durée Durée d'exécution de l'épisode au format ISO 8601. Veuillez utiliser le format suivant : "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - Un PublicationEvent permet d'indiquer la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme sa date de sortie en salle.

Vous pouvez également utiliser FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, sélectionné, spécial, etc.

ExclusiveEvent indique que votre service dispose de droits de distribution exclusifs, et inclut où et quand.

Consultez la section Exemples pour obtenir des détails et des exemples.
releasedEvent.@type Texte Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : régions associées à cet événement.

Pour une PublicationEvent, il s'agit de la région dans laquelle le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est présenté ou exclusif.

Utilisez les codes ISO 3166 pour les pays. Pour indiquer partout dans le monde, définissez la valeur sur EARTH.
releasedEvent.startDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : date de début de la publication de l'entité.

Pour PublicationEvent, il s'agit de la date de sortie initiale de cette entité, par exemple la date de la première sortie du film en salle.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début à laquelle l'entité est mise en avant ou exclusive.
releasedEvent.endDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : s'applique uniquement aux types ExclusiveEvent et FeaturedEvent.

Pour ExclusiveEvent, il s'agit de la date d'expiration des droits du contenu.

Pour FeaturedEvent, il s'agit de la dernière date à laquelle le fournisseur présente l'entité.

Si le contenu est exclusif ou mis en avant en permanence, définissez endDate sur 20 ans à compter de la date du jour.
releasedEvent.publishedBy Organisation ou personne Facultatif. Organisation ou personne ayant publié cette entité.
description Texte Fortement recommandé Pourquoi ? Un résumé de l'épisode. Les résumés de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum.
genre Texte Liste numérotée de tous les genres pertinents. Par exemple : ["Action", "Fashion", "Environment", "Football"]
keywords Texte Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés permettant de décrire le contenu.
actor Person, PerformingGroup ou PerformanceRole Fortement recommandé Pourquoi ? Tableau des acteurs de l'épisode. Pour obtenir des conseils de modélisation, cliquez ici.
director Personne Fortement recommandé Pourquoi ? Réalisateur(s) de l'épisode.
producer Organisation ou personne Fortement recommandé Pourquoi ? Producteur(s) de la saison.
image ImageObject Pourquoi fortement recommandé pour Google TV : différentes images liées à "TVEpisode". Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez Propriétés de l'image.
trailer.description Texte Description de la bande-annonce. Consultez l'exemple de bande-annonce.
trailer.inLanguage Texte Langue de la bande-annonce au format BCP 47.
trailer.url URL URL d'une bande-annonce hébergée publiquement et mise en ligne par les studios de production respectifs ou des sources autorisées.
trailer.regionsAllowed Place Régions dans lesquelles le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
review Avis Voir les classifications pour l'épisode de série TV
review.reviewRating Note Obligatoire si review est fourni Cette valeur permet de spécifier la note attribuée à l'avis.
contentRating Text ou Rating Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas : classification globale du contenu. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées:
  • L'agence de notation a été ajoutée avant la note par un espace blanc. Par exemple, "TV-MA" note de l'agence "TVPG" aux États-Unis doit être désigné par la mention "TVPG TV-MA". Consultez la liste des agences.
  • La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'agence de classification. Consultez la page Agences de classification de contenu pour consulter la liste des agences de classification acceptées.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.
identifier PropertyValue Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau de popularité d'une entité est défini sur 0.
popularityScore.@type Texte Toujours défini sur PopularityScoreSpecification.
popularityScore.value Number Valeur numérique non négative indiquant la popularité de l'entité. un score élevé signifie une popularité plus élevée.
popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).

TVSeason

Propriété Type attendu Description
@context Texte Obligatoire : toujours défini sur ["http://schema.org", {"@language": "xx"}]
  • Où ?" xx pouces représente la langue des chaînes du flux. La balise @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres est l'anglais.
@type Texte Obligatoire : toujours défini sur TVSeason.
@id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
@id doit remplir les conditions suivantes:
  • Unique au niveau mondial dans votre catalogue
  • L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un identifiant de ressource unifié (URI)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit respecter les exigences suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
Pour le lien profond de la lecture, consultez plutôt la propriété urlTemplate de l'objet cible.
name Texte Obligatoire : nom de la saison de série TV.
  • Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Représentation dans plusieurs langages.
  • Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? : identifiant EIDR (Entertainment Identifier Registry) représentant au niveau le plus général/abstrait d'une œuvre de film ou de télévision.

Exemple : titre EIDR de la première saison de l'émission télévisée "Game of Thrones" est "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber Entier Obligatoire : numéro indiquant la position de la saison dans l'ordre des saisons de la série TV.
partOfSeries TVSeries Obligatoire : série TV à laquelle appartient cette saison.
partOfSeries.@type Texte Obligatoire : toujours défini sur TVSeries.
partOfSeries.@id URL Obligatoire : @id des TVSeries auxquels cette saison fait partie.
partOfSeries.name Texte Obligatoire : nom de la série TV.
partOfSeries.sameAs Texte URL d'une page Web de référence permettant d'identifier l'émission. par exemple, la page Wikipédia de l'émission. Elle doit être distincte de la propriété url.
potentialAction WatchAction Obligatoire, le cas échéant : un objet de balisage Action qui fournit les détails de l'action.
  • Si le contenu est disponible pour la vidéo à la demande (VoD), cette propriété est obligatoire. L'objet de balisage Action doit fournir le lien profond du contenu.
  • Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. À la place, l'entité BroadcastService associée fournit le lien profond du canal.
  • Un TVSeason peut être disponible à la fois sur VoD et LiveTV.
Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
sameAs URL Fortement recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier la saison. par exemple, la page Wikipédia de la saison. Elle doit être distincte de la propriété url.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - Un PublicationEvent permet d'indiquer la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme sa date de sortie en salle.

Vous pouvez également utiliser FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, sélectionné, spécial, etc.

ExclusiveEvent indique que votre service dispose de droits de distribution exclusifs, et indique où et quand.

Consultez la section Exemples pour obtenir des détails et des exemples.
releasedEvent.@type Texte Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : régions associées à cet événement.

Pour une PublicationEvent, il s'agit de la région dans laquelle le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est présenté ou exclusif.

Utilisez les codes ISO 3166 pour les pays. Pour indiquer partout dans le monde, définissez la valeur sur EARTH.
releasedEvent.startDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : date de début de la publication de l'entité.

Pour PublicationEvent, il s'agit de la date de sortie initiale de cette entité, par exemple la date de la première sortie du film en salle.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début à laquelle l'entité est mise en avant ou exclusive.
releasedEvent.endDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : s'applique uniquement aux types ExclusiveEvent et FeaturedEvent.

Pour ExclusiveEvent, il s'agit de la date d'expiration des droits du contenu.

Pour FeaturedEvent, il s'agit de la dernière date à laquelle le fournisseur présente l'entité.

Si le contenu est exclusif ou mis en avant en permanence, définissez endDate sur 20 ans à compter de la date du jour.
releasedEvent.publishedBy Organisation ou personne Facultatif. Organisation ou personne ayant publié cette entité.
description Texte Fortement recommandé Pourquoi ? Résumé de la saison. Les résumés de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum.
actor [Person ou PerformingGroup ou PerformanceRole Fortement recommandé Pourquoi ? Tableau des acteurs de la saison. Pour obtenir des conseils de modélisation, cliquez ici.
director Personne Fortement recommandé Pourquoi ? Tableau des réalisateurs de l'émission.
producer Organisation ou personne Fortement recommandé Pourquoi ? Producteur(s) de la saison.
image ImageObject Images associées à la saison télévisée. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez Propriétés de l'image.
genre Texte Liste numérotée de tous les genres pertinents. Par exemple : ["Action", "Fashion", "Environment", "Football"]
keywords Texte Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés permettant de décrire le contenu.
trailer.description Texte Description de la bande-annonce. Consultez l'exemple de bande-annonce.
trailer.inLanguage Texte Langue de la bande-annonce au format BCP 47.
trailer.url URL URL d'une bande-annonce hébergée publiquement et mise en ligne par les studios de production respectifs ou des sources autorisées.
trailer.regionsAllowed Place Régions dans lesquelles le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
identifier PropertyValue Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau de popularité d'une entité est défini sur 0.
popularityScore.@type Texte Toujours défini sur PopularityScoreSpecification.
popularityScore.value Number Valeur numérique non négative indiquant la popularité de l'entité. un score élevé signifie une popularité plus élevée.
popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).
review Avis Voir les notes pour la saison de série TV
review.reviewRating Note Obligatoire si review est fourni Cette valeur permet de spécifier la note attribuée à l'avis.
contentRating Text ou Rating Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas : classification globale du contenu. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées:
  • L'agence de notation a été ajoutée avant la note par un espace blanc. Par exemple, "TV-MA" note de l'agence "TVPG" aux États-Unis doit être désigné par la mention "TVPG TV-MA". Consultez la liste des agences.
  • La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du contenu.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'agence de classification. Consultez la page Agences de classification de contenu pour consulter la liste des agences de classification acceptées.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.

Spécifications des acteurs

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

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

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

Utiliser les types Person ou PerformingGroup

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

Propriété Type attendu Description
@type Person ou PerformingGroup Required : toujours défini sur Person ou PerformingGroup
@id URL Fortement recommandé Pourquoi ? - L'identifiant des acteurs ou du groupe d'exécution au format URI par exemple https://example.com/actor/abc. @id doit répondre aux exigences suivantes:
  • Unique au niveau mondial dans votre catalogue par acteur/groupe performant
  • Cet identifiant doit être stable et immuable dans le temps. Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un identifiant de ressource unifié (URI)
  • Votre organisation doit être propriétaire du domaine utilisé pour la valeur @id.

Notez que le @id utilisé dans la propriété de l'acteur doit être utilisé de manière cohérente dans tout le flux. Par exemple, s'il y a deux films avec le même acteur, la valeur @id doit être la même pour ces deux objets d'acteur.

name Texte Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe d'acteurs.
sameAs URL Fortement recommandé Pourquoi ? – Une URL vers une page Web de référence qui peut identifier l'acteur ou le groupe actif par exemple, la page Wikipédia de l'acteur. Elle doit être distincte de la propriété @id.

Utiliser le type PerformanceRole

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

Propriété Type attendu Description
@type PerformanceRole Obligatoire : toujours défini sur PerformanceRole
roleName Texte Fortement recommandé Pourquoi ? : rôle joué, interprété ou rempli par l'acteur. Pour consulter la liste des valeurs acceptées, cliquez ici.
characterName Texte Nom d'un personnage occupant un rôle d'acteur ou de danse. Ne définissez pas ce champ si le type d'acteur est PerformingGroup.
actor Person ou PerformingGroup Obligatoire -
  • Membres de la distribution du contenu lorsque le type de données Person est utilisé.
  • Groupe(s) d'exécution/bande(s) du contenu lorsque le type de données PerformingGroup est utilisé.
actor.@type Person ou PerformingGroup Required : toujours défini sur Person ou PerformingGroup
actor.@id URL Fortement recommandé Pourquoi ? - L'identifiant de l'acteur ou du groupe d'exécution au format URI par exemple https://example.com/actor/abc. @id doit répondre aux exigences suivantes:
  • Unique au niveau mondial dans votre catalogue par acteur/groupe performant
  • Cet identifiant doit être stable et immuable dans le temps. Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un identifiant de ressource unifié (URI)
  • Votre organisation doit être propriétaire du domaine utilisé pour la valeur @id.

Notez que le @id utilisé dans la propriété de l'acteur doit être utilisé de manière cohérente dans tout le flux. Par exemple, s'il y a deux films avec le même acteur, la valeur @id doit être la même pour ces deux objets d'acteur.

actor.name Texte Obligatoire : nom de l'acteur, de l'actrice, du membre de la distribution ou du groupe d'acteurs.
actor.sameAs URL Fortement recommandé Pourquoi ? – Une URL vers une page Web de référence qui peut identifier l'acteur ou le groupe actif par exemple, la page Wikipédia de l'acteur. Il doit être distinct de la propriété actor.@id.

Noms de rôles autorisés

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

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

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

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

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

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

Exemples

Exemple pour TVSeries, TVEpisode et TVSeason

TVSeries

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

TVEpisode

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

TVSeason

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

Exemples de propriétés Actor

Le rôle de l'acteur est inconnu

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

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

Le rôle de l'acteur est connu

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

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

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

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

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

Consultez les pages suivantes pour en savoir plus sur les sujets liés à ces propriétés: