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.
Table de spécifications 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 contenu au format URI (par exemple, https://example.com/1234abc).@id doit répondre aux exigences suivantes :
url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser le url d'une entité comme @id. Pour en savoir plus, consultez la section Identifiant. |
name |
Texte | Obligatoire : titre de la série ou de l'événement. |
description |
Texte | Description de l'émission ou de l'événement. 300 caractères maximum. Utilisez un tableau pour inclure les descriptions dans plusieurs langues et de différentes longueurs. |
startDate |
Date | Obligatoire : heure de début de l'événement au format ISO 8601 avec le 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 TV, n'indiquez 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 fortement 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é événement. L'entité événement doit exister dans le flux et avoir un @id différent de celui de BroadcastEvent. |
location |
Text ou Country | 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 l'événement sportif peut être diffusé dans plusieurs pays. |
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 si le fournisseur ne dispose pas d'informations à jour sur ce qui sera diffusé, et sur false dans le cas contraire.Il est fortement recommandé qu'une entité BroadcastEvent inclue au moins l'un des éléments suivants :
|
offAir |
Valeur booléenne | Obligatoire, le cas échéant : utilisez cette propriété si aucune diffusion de contenu n'est prévue pour le créneau horaire. Il est fortement recommandé qu'une entité BroadcastEvent inclue au moins l'un des éléments suivants :
|
isLiveBroadcast |
Valeur booléenne | Définissez sur true s'il s'agit d'un événement en direct (par exemple, un événement sportif ou un concert). |
potentialAction |
WatchAction | Obligatoire, le cas échéant : si le contenu est diffusé en tant qu'événement de streaming en direct sans chaîne (avec contentToBeAnnounced défini sur false ou offAir défini sur false), utilisez cette propriété pour fournir le lien profond de l'événement. |
identifier |
PropertyValue | ID externe qui identifie le contenu de la diffusion. Pour en savoir plus, consultez la section Propriétés des identifiants.
|
contentRating |
Text ou Rating | Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas Pourquoi ? - Classification globale du contenu de la diffusion. 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 classification. |
contentRating.advisoryCode |
Texte | Code d'avertissement pour le contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langage, S = 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 montrant 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": "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 midi et 20h, et diffuse une émission nommée My favorite show entre 20h et midi :
BroadcastEvent
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "BroadcastEvent",
"@id": "http://example.com/randomUniqueEventId1",
"name": “Off Air”,
"startDate": "2019-10-12T00: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/randomUniqueEventId2",
"startDate": "2019-10-12T20:00-08:00",
"endDate": "2019-10-13T00:00-08:00",
"videoFormat": "HD",
"isLiveBroadcast": false,
"name": "My favorite show",
"workPerformed": {
...
},
"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 thèmes liés à ces propriétés :