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

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

L'utilisation de TVSeason en tant qu'entité complète est facultative. Pour en savoir plus, consultez la section Relations entre les séries télévisées, les saisons et les épisodes de séries télévisées.

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 du flux. Le contexte de chaque entité racine doit être défini sur le code de langue approprié, au format BCP 47. Par exemple, si la langue est l'espagnol, les noms sont considérés comme étant en espagnol, même si la langue du sous-titre est en anglais.
@type Texte Obligatoire : toujours défini 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 mondial dans votre catalogue
  • Statique. L'ID doit être stable et ne pas changer au fil du temps (même si la propriété de l'URL de l'émission change). Elle est 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é qu'une entité url répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser une url d'entité comme @id. Consultez la section Identifiant pour en savoir plus.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux avec le contenu des bases de données de Google.
url doit répondre aux exigences suivantes :
  • url doit être unique au niveau mondial
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
Pour les liens profonds de lecture, consultez plutôt la propriété urlTemplate de l'objet cible.
name Texte Obligatoire : nom de l'émission.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? - Identifiant EIDR (Entertainment Identifier Registry) représentant au niveau général/abstrait une œuvre de cinéma ou de télévision.

Par exemple, le titre "EIDR" pour la série télévisée "Game of Thrones" est "10.5240/C1B5-3BA1-8991-A571-8472-W".
potentialAction WatchAction Obligatoire, le cas échéant : objet de balisage d'action qui fournit les détails de l'action.
  • Si le contenu est disponible à 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 Live TV, cette propriété est facultative. L'entité BroadcastService associée fournit le lien profond de la chaîne.
  • Un 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 recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier l'émission (par exemple, sa page Wikipédia). Ce champ 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. Délimitez plusieurs entrées à l'aide de virgules. Par exemple, les mots clés "description" et "biographie" peuvent être utilisés pour décrire le contenu.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - On utilise un attribut PublicationEvent pour préciser la sortie d'un contenu original (monde ou international) par un éditeur, comme la date de sortie originale d'un film.

Utilisez également FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, spécial, spécial, etc.

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

Consultez la section dédiée pour obtenir des détails et des exemples.
releasedEvent.@type Texte Obligatoire : veillez à toujours définir cette propriété sur l'une des valeurs suivantes :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : région associée à cet événement.

Pour un PublicationEvent, il s'agit de la région où le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est 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 une PublicationEvent, il s'agit de la date de sortie initiale de cette entité, telle que la date de sortie du film en salle.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début de l'exclusivité ou de la présentation 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 d'expiration des droits sur le contenu.

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

Si le contenu est exclusif ou présenté en permanence, définissez la valeur endDate sur 20 ans à partir de la date actuelle.
releasedEvent.publishedBy Organisation ou personne Facultatif : organisation ou personne qui a publié cette entité.
description Texte Fortement recommandé Pourquoi ? Synopsis de l'émission. Les synopsis des graphiques sont préférables aux résumés factuels. 300 caractères maximum.
actor Person / PerformanceRole Fortement recommandé Pourquoi ? Tableau des membres récurrents de la série. Utilisez le type de données "Personne" si le nom de l'acteur est inconnu. Utilisez le type de données PerformanceRole dans le cas contraire. Pour PerformanceRole, fournissez les propriétés actor.characterName et actor.actor.
actor.actor Personne L'acteur / l'actrice
actor.characterName Texte Nom d'un personnage incarné ou jouant un rôle
director Personne Fortement recommandé Pourquoi ? Réalisateur de la série.
producer Organisation ou personne Fortement recommandé 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 la section 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 d'une bande-annonce hébergée publiquement et mise en ligne par des studios de production ou des sources autorisées respectifs.
trailer.regionsAllowed Établissement Régions où le contenu multimédia est autorisé. Si elle n'est pas spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
popularityScore PopularitéScoreScore Fortement recommandé Pourquoi ? Score que Google utilise, 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 vos flux, parmi 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é. Un score élevé signifie une plus grande popularité.
popularityScore.eligibleRegion Pays Région(s) dans laquelle le niveau de popularité s'applique. Si le niveau de popularité est applicable dans le monde entier, définissez la valeur sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité selon les paramètres régionaux prévaut sur la popularité globale (EARTH)
review Avis Avis sur la série TV
review.reviewRating Note Obligatoire si review est fourni : permet de spécifier la note attribuée à l'avis.
contentRating Texte ou Note Obligatoire pour le contenu réservé aux adultes, vivement 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 :
  • Organisme de classification préfixé par un espace blanc. Par exemple, une classification "TV-MA" des agences aux États-Unis doit être décrite comme "TV-TV TV-MA". Consultez la liste des agences.
  • La valeur "NOT 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 du 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 de notification pour le contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = violence fictive, L = Language, 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 du flux. Le contexte de chaque entité racine doit être défini sur le code de langue approprié, au format BCP 47. Par exemple, si la langue est l'espagnol, les noms sont considérés comme étant en espagnol, même si la langue du sous-titre est en anglais.
@type Texte Obligatoire : toujours défini 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 mondial dans votre catalogue
  • Statique. L'ID doit être stable et ne pas changer au fil du temps (même si la propriété de l'URL de l'émission change). Elle est 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é qu'une entité url répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser une url d'entité comme @id. Consultez la section Identifiant pour en savoir plus.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux avec le contenu des bases de données de Google.
url doit répondre aux exigences suivantes :
  • url doit être unique au niveau mondial
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
Pour les liens profonds de 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 Utilisation de plusieurs langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? - Identifiant EIDR (Entertainment Identifier Registry) représentant au niveau général/abstrait une œuvre de cinéma ou de télévision.

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 recommandé Pourquoi ? - Identifiant EIDR (Entertainment Identifier Registry) représentant une modification / édition spécifique pour une œuvre de cinéma ou de télévision.

Par exemple, le premier épisode de la première saison de "TVSeries", connu sous le nom de "Game of Thrones" et dont le titre EIDR est "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X"", a été publié par exemple

titleEIDR La propriété est obligatoire lorsque l'élément EIDR 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 la série TV à laquelle appartient cet épisode.

Même si un élément TVEpisode n'a pas de TVSeason correspondant, vous devez tout de même indiquer les propriétés partOfSeason.@id et partOfSeason.seasonNumber. Solution de contournement:
  • Prenons l'exemple de partofSeries.@id (par exemple, http://www.example.com/my_favorite_tv_show) et joignez un champ de requête d'espace réservé (?season1, par exemple) pour créer un élément partOfSeason.@id unique (par exemple, http://www.example.com/my_favorite_tv_show?season1).
  • Définissez partOfSeason.seasonNumber sur 1.
partOfSeason.@type Texte Obligatoire : toujours défini sur TVSeason.
partOfSeason.@id URL Obligatoire@id du TVSeason dans lequel se trouve cet épisode.
partOfSeason.seasonNumber Entier Obligatoire : nombre indiquant la position de cette saison dans l'ordre des saisons de la série télévisée.
partOfSeries Séries TV Obligatoire : série TV à laquelle appartient l'épisode.
partOfSeries.@type Texte Obligatoire : toujours défini sur TVSeries.
partOfSeries.@id URL Obligatoire@id du TVSeries dans lequel se trouve cet épisode.
partOfSeries.name Texte Obligatoire : nom de la série TV.
partOfSeries.sameAs Texte URL d'une page Web de référence permettant d'identifier l'émission (par exemple, sa page Wikipédia). Ce champ 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 à 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 Live TV, cette propriété est facultative. L'entité BroadcastService associée fournit le lien profond de la chaîne.
  • Un 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 recommandé Pourquoi ? URL URL d'une page Web de référence permettant d'identifier l'épisode. (Par exemple, la page Wikipédia de l'épisode). Ce champ 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 recommandé Pourquoi ? - On utilise un attribut PublicationEvent pour préciser la sortie d'un contenu original (monde ou international) par un éditeur, comme la date de sortie originale d'un film.

Utilisez également FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, spécial, spécial, etc.

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

Consultez la section dédiée pour obtenir des détails et des exemples.
releasedEvent.@type Texte Obligatoire : veillez à toujours définir cette propriété sur l'une des valeurs suivantes :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : région associée à cet événement.

Pour un PublicationEvent, il s'agit de la région où le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est 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 une PublicationEvent, il s'agit de la date de sortie initiale de cette entité, telle que la date de sortie du film en salle.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début de l'exclusivité ou de la présentation 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 d'expiration des droits sur le contenu.

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

Si le contenu est exclusif ou présenté en permanence, définissez la valeur endDate sur 20 ans à partir de la date actuelle.
releasedEvent.publishedBy Organisation ou personne Facultatif : organisation ou personne qui a publié cette entité.
description Texte Fortement recommandé Pourquoi ? Synopsis de l'épisode. Les synopsis des graphiques sont préférables aux résumés factuels. 300 caractères maximum.
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. Délimitez plusieurs entrées à l'aide de virgules. Par exemple, les mots clés "description" et "biographie" peuvent être utilisés pour décrire le contenu.
actor Person/PerformanceRole Fortement recommandé Pourquoi ? Le ou les membres de la distribution de l'épisode. Utilisez le type de données "Personne" si le nom de l'acteur est inconnu. Utilisez le type de données PerformanceRole dans le cas contraire. Pour PerformanceRole, fournissez les propriétés actor.characterName et actor.actor.
actor.actor Personne L'acteur / l'actrice
actor.characterName Texte Nom d'un personnage incarné ou jouant un rôle
director Personne Fortement recommandé Pourquoi ? Réalisateur de l'épisode.
producer Organisation ou personne Fortement recommandé Pourquoi ? Le ou les producteurs de la saison.
image ImageObject Fortement recommandé pourquoi ? pour Google TV : plusieurs images en rapport avec l'épisode de la série. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez la section 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 d'une bande-annonce hébergée publiquement et mise en ligne par des studios de production ou des sources autorisées respectifs.
trailer.regionsAllowed Établissement Régions où le contenu multimédia est autorisé. Si elle n'est pas spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
review Avis Avis sur l'épisode de série TV
review.reviewRating Note Obligatoire si review est fourni : permet de spécifier la note attribuée à l'avis.
contentRating Texte ou Note Obligatoire pour le contenu réservé aux adultes, vivement 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:
  • Organisme de classification préfixé par un espace blanc. Par exemple, une classification "TV-MA" des agences aux États-Unis doit être décrite comme "TV-TV TV-MA". Consultez la liste des agences.
  • La valeur "NOT 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 du 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 de notification pour le contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = violence fictive, L = Language, S = Contenu à caractère sexuel, V = Violence.
identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
popularityScore PopularitéScoreScore Fortement recommandé Pourquoi ? Score que Google utilise, 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 vos flux, parmi 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é. Un score élevé signifie une plus grande popularité.
popularityScore.eligibleRegion Pays Région(s) dans laquelle le niveau de popularité s'applique. Si le niveau de popularité est applicable dans le monde entier, définissez la valeur sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité selon les paramètres régionaux prévaut 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" représente la langue des chaînes du flux. Le contexte de chaque entité racine doit être défini sur le code de langue approprié, au format BCP 47. Par exemple, si la langue est l'espagnol, les noms sont considérés comme étant en espagnol, même si la langue du sous-titre est en anglais.
@type Texte Obligatoire : toujours défini 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 mondial dans votre catalogue
  • Statique. L'ID doit être stable et ne pas changer au fil du temps (même si la propriété de l'URL de l'émission change). Elle est 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é qu'une entité url répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser une url d'entité comme @id. Consultez la section Identifiant pour en savoir plus.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux avec le contenu des bases de données de Google.
url doit répondre aux exigences suivantes :
  • url doit être unique au niveau mondial
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
Pour les liens profonds de 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 Utilisation de plusieurs langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? - Identifiant EIDR (Entertainment Identifier Registry) représentant au niveau général/abstrait une œuvre de cinéma ou de télévision.

Par exemple, le titre EIDR 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 télévisée.
partOfSeries Séries TV Obligatoire : série TV à laquelle s'applique cette saison.
partOfSeries.@type Texte Obligatoire : toujours défini sur TVSeries.
partOfSeries.@id URL Obligatoire : @id de l'attribut TVSeries dont la 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, sa page Wikipédia). Ce champ 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 à 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 Live TV, cette propriété est facultative. L'entité BroadcastService associée fournit le lien profond de la chaîne.
  • Un 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 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). Ce champ doit être différent de la propriété url.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? – Une PublicationEvent est utilisée pour préciser la sortie originale (monde ou mondiale) d'un contenu par un éditeur, comme la date de sortie originale en salles d'un film.

Utilisez également FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, spécial, spécial, etc.

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

Consultez la section dédiée pour obtenir des détails et des exemples.
releasedEvent.@type Texte Obligatoire : veillez à toujours définir cette propriété sur l'une des valeurs suivantes :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : région associée à cet événement.

Pour un PublicationEvent, il s'agit de la région où le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est 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 une PublicationEvent, il s'agit de la date de sortie initiale de cette entité, telle que la date de sortie du film en salle.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début de l'exclusivité ou de la présentation 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 d'expiration des droits sur le contenu.

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

Si le contenu est exclusif ou présenté en permanence, définissez la valeur endDate sur 20 ans à partir de la date actuelle.
releasedEvent.publishedBy Organisation ou personne Facultatif : organisation ou personne qui a publié cette entité.
description Texte Fortement recommandé Pourquoi ? Un synopsis de la saison Les synopsis des graphiques sont préférables aux résumés factuels. 300 caractères maximum.
actor Person/PerformanceRole Fortement recommandé Pourquoi ? Tableau des membres récurrents de la saison. Utilisez le type de données "Personne" si le nom de l'acteur est inconnu. Utilisez le type de données PerformanceRole dans le cas contraire. Pour PerformanceRole, fournissez les propriétés actor.characterName et actor.actor.
actor.actor Personne L'acteur / l'actrice
actor.characterName Texte Nom d'un personnage incarné ou jouant un rôle
director Personne Fortement recommandé Pourquoi ? Tableau des réalisateurs de l'émission.
producer Organisation ou personne Fortement recommandé Pourquoi ? Le ou les producteurs de la saison.
image ImageObject Images associées à la saison télévisée. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez la section Propriétés 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. Délimitez plusieurs entrées à l'aide de virgules. Par exemple, les mots clés "description" et "biographie" peuvent être utilisés pour décrire 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 d'une bande-annonce hébergée publiquement et mise en ligne par des studios de production ou des sources autorisées respectifs.
trailer.regionsAllowed Établissement Régions où le contenu multimédia est autorisé. Si elle n'est pas spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
popularityScore PopularitéScoreScore Fortement recommandé Pourquoi ? Score que Google utilise, 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 vos flux, parmi 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é. Un score élevé signifie une plus grande popularité.
popularityScore.eligibleRegion Pays Région(s) dans laquelle le niveau de popularité s'applique. Si le niveau de popularité est applicable dans le monde entier, définissez la valeur sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité selon les paramètres régionaux prévaut sur la popularité globale (EARTH)
review Avis Avis sur la saison de série TV
review.reviewRating Note Obligatoire si review est fourni : permet de spécifier la note attribuée à l'avis.
contentRating Texte ou Note Obligatoire pour le contenu réservé aux adultes, vivement 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 :
  • Organisme de classification préfixé par un espace blanc. Par exemple, une classification "TV-MA" des agences aux États-Unis doit être décrite comme "TV-TV TV-MA". Consultez la liste des agences.
  • La valeur "NOT 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 du 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 de notification pour le contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = violence fictive, L = Language, S = Contenu à caractère sexuel, V = Violence.

Exemples

Exemples de TVSeries, TVEpisode et TVSeason.

TVSeries

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

Consultez les pages suivantes pour les sujets liés à ces propriétés: