Cette section fournit des informations détaillées sur les propriétés de balisage de contenu pour le type d'entité BroadcastEvent. Pour mieux comprendre la relation entre ces types, consultez les concepts Événements LiveTV.
Tableau de spécification BroadcastEvent
| Propriété | Type attendu | Description |
|---|---|---|
@context |
Texte | Obligatoire : toujours défini sur ["http://schema.org", {"@language": "xx"}]
|
@type |
Texte | Obligatoire : toujours défini sur BroadcastEvent. |
@id |
URL | Obligatoire : identifiant du créneau de diffusion au format URI, par exemple https://example.com/live/channel1/20191012T2100.@id doit respecter les exigences suivantes :
url sur BroadcastEvent ou SportsEvent. Indiquez l'élément url canonique uniquement sur l'entité de contenu sous-jacente (Movie, TVSeries ou TVEpisode). Pour en savoir plus, consultez la section Identifiant. |
name |
Texte | Obligatoire : titre de l'émission ou de l'événement. |
description |
Texte | Description du spectacle ou de l'événement. 300 caractères maximum. Utilisez un tableau pour inclure des descriptions dans plusieurs langues (une par langue). |
startDate |
Date | Obligatoire : heure de début de l'événement au format ISO 8601 avec fuseau horaire. |
endDate |
Date | Heure de fin de l'événement au format ISO 8601 avec fuseau horaire. |
publishedOn |
BroadcastService | Obligatoire, le cas échéant : spécifiez l'entité BroadcastService qui diffuse cette émission ou cet événement.Si le contenu est diffusé sur une chaîne de télévision, cette propriété est obligatoire. Si le contenu n'est associé à aucune chaîne de télévision, ne fournissez pas cette propriété. |
publishedOn.@type |
Texte | Définissez cet élément sur BroadcastService. |
publishedOn.@id |
URL | @id de l'entité BroadcastService qui diffuse cette émission ou cet événement. |
workPerformed |
CreativeWork | Obligatoire, le cas échéant : utilisez cette propriété lorsque le contenu correspond à l'un des types d'entités suivants : Movie, TVSeries et TVEpisode.Il est vivement recommandé qu'une entité BroadcastEvent inclue au moins l'un des éléments suivants :
|
workPerformed.@type |
Texte | Définissez-le sur Movie, TVSeries ou TVEpisode. |
workPerformed.@id |
URL | @id de l'entité de contenu. |
broadcastOfEvent |
SportsEvent | Obligatoire, le cas échéant : utilisez cette propriété si le contenu est un événement en direct.
Nous vous recommandons vivement d'inclure au moins l'un des éléments suivants dans une entité BroadcastEvent :
|
broadcastOfEvent.@type |
Texte | Définissez cet élément sur SportsEvent. |
broadcastOfEvent.@id |
URL | @id de l'entité d'événement. L'entité d'événement doit exister dans le flux et avoir un @id différent de celui de BroadcastEvent. |
location |
Texte ou Pays | Obligatoire si BroadcastEvent concerne un SportsEvent, c'est-à-dire s'il possède la propriété broadcastOfEvent : pays dans lequel le SportsEvent sous-jacent peut être diffusé. Ce champ peut être une liste de pays si plusieurs pays peuvent diffuser l'événement sportif. |
videoFormat |
Texte | Définition de la plus haute qualité compatible avec ce service de diffusion, par exemple :
|
contentToBeAnnounced |
Valeur booléenne | Obligatoire, le cas échéant : utilisez cette propriété si le contenu est inconnu au moment de la création du flux. Définissez la valeur sur true lorsque le fournisseur ne dispose pas d'informations à jour sur ce qui sera diffusé, ou sur false dans le cas contraire.Nous vous recommandons vivement d'inclure au moins l'un des éléments suivants dans une entité BroadcastEvent :
|
offAir |
Valeur booléenne | Obligatoire, le cas échéant : définissez la valeur sur true lorsqu'aucun contenu n'est prévu pour le créneau horaire sur une chaîne BroadcastService.
BroadcastEvent :
|
isLiveBroadcast |
Valeur booléenne | Définissez la valeur booléenne true (sans guillemets) si cette diffusion est en direct (par exemple, un match de sport ou un journal télévisé en direct), ou false pour les programmes non diffusés en direct et les rediffusions. |
potentialAction |
WatchAction | Obligatoire, le cas échéant : ne fournissez jamais potentialAction sur un BroadcastEvent lorsque broadcastOfEvent fait référence à un SportsEvent (placez tous les liens profonds de sport sur SportsEvent.potentialAction) ou lorsque publishedOn fait référence à une chaîne BroadcastService (placez les liens profonds de chaîne sur BroadcastService.potentialAction). Ne fournissez BroadcastEvent.potentialAction que pour les diffusions en direct sans chaîne qui ne font pas référence à un SportsEvent (par exemple, un contenu supplémentaire en direct autonome avec contentToBeAnnounced et offAir omis ou false). |
identifier |
PropertyValue | ID externe qui identifie le contenu diffusé. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
|
contentRating |
Texte ou Note | Obligatoire pour le contenu réservé aux adultes, vivement recommandé pour les autres contenus Pourquoi ? - Classification globale du contenu diffusé. Si la classification du contenu est fournie sous la forme d'une chaîne de texte, deux variantes sont acceptées :
|
contentRating.author |
Entreprise | Obligatoire si contentRating utilise Rating : nom de l'organisme de classification. |
contentRating.ratingValue |
Texte | Obligatoire si contentRating utilise Rating : valeur de la note. |
contentRating.advisoryCode |
Texte | Code de l'avertissement pour le contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Fantasy Violence (violence fantastique), L = Language (langage), S = Sexual Content (contenu à caractère sexuel), V = Violence. |
Exemples
Un épisode de série TV est diffusé sur la chaîne de télévision Example TV (BroadcastService) entre 21h et 21h30 le 12 octobre 2019 :
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
"name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
"description": "Three mice leave the town and the trip turns into something more.",
"startDate": "2019-10-12T21:00-08:00",
"endDate": "2019-10-12T21:30-08:00",
"videoFormat": "HD",
"isLiveBroadcast": false,
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"workPerformed": {
"@type": "TVEpisode",
"@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
}
}
BroadcastService
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
Exemple illustrant l'utilisation de la propriété contentToBeAnnounced lorsque le contenu à diffuser sur la chaîne de télévision Example TV (BroadcastService) entre 21h et 21h30 le 12 octobre 2019 n'est pas connu au moment de la création du flux :
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId",
"name": "Content To Be Announced",
"description": "Content To Be Announced",
"startDate": "2019-10-12T21:00-08:00",
"endDate": "2019-10-12T21:30-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"contentToBeAnnounced": true
}
BroadcastService
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
La chaîne de télévision Example TV (BroadcastService) est hors antenne entre 12h et 20h (modélisée sous la forme de deux blocs Off Air contigus de quatre heures) et diffuse une émission intitulée My favorite show entre 20h et minuit :
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId1",
"name": "Off Air",
"description": "Off Air",
"startDate": "2019-10-12T12:00-08:00",
"endDate": "2019-10-12T16:00-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"offAir": true
},
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId2",
"name": "Off Air",
"description": "Off Air",
"startDate": "2019-10-12T16:00-08:00",
"endDate": "2019-10-12T20:00-08:00",
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
},
"offAir": true
},
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId3",
"name": "My favorite show",
"description": "Evening broadcast of My favorite show.",
"startDate": "2019-10-12T20:00-08:00",
"endDate": "2019-10-13T00:00-08:00",
"videoFormat": "HD",
"isLiveBroadcast": false,
"workPerformed": {
"@type": "TVSeries",
"@id": "http://example.com/tv_series/my_favorite_show"
},
"publishedOn": {
"@type": "BroadcastService",
"@id": "http://example.com/stations/example_tv"
}
}
BroadcastService
{
"@context":"http://schema.org",
"@type":"BroadcastService",
"@id":"http://example.com/stations/example_tv",
"name":"EXAMPLE-TV",
"broadcastDisplayName":"ABCD",
"callSign": "EXA-TV",
"videoFormat":"SD",
"broadcastTimezone":"America/Los_Angeles",
"broadcastAffiliateOf":{
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"identifier": "example.com:basic",
"commonTier": false
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
}
À lire également
Consultez les pages suivantes pour en savoir plus sur les sujets liés à ces propriétés :