Cette section fournit des informations 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 sur les événements LiveTV.
Tableau des spécifications de BroadcastEvent
| Propriété | Type attendu | Description |
|---|---|---|
@context |
Texte | Obligatoire : doit toujours être défini sur ["http://schema.org", {"@language": "xx"}]
|
@type |
Texte | Obligatoire : doit toujours être défini sur BroadcastEvent. |
@id |
URL | Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).@id doit respecter les conditions 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 l'émission 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 fuseau horaire. |
endDate |
Date | Heure de fin de l'événement au format ISO 8601 avec fuseau horaire. |
publishedOn |
BroadcastService | Obligatoire si applicable : indiquez 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 est l'un des types d'entités suivants : Movie, TVSeries et TVEpisode.Nous vous recommandons vivement d'inclure au moins l'un des éléments suivants dans une entité BroadcastEvent :
|
workPerformed.@type |
Texte | Définissez-la sur Movie, TVSeries ou TVEpisode. |
workPerformed.@id |
URL | @id de l'entité de contenu. |
broadcastOfEvent |
SportsEvent | Obligatoire si applicable : 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 |
Text ou Country | Obligatoire si BroadcastEvent est destiné à un événement sportif, c'est-à-dire s'il possède la propriété broadcastOfEvent : pays dans lequel l'événement sportif sous-jacent peut être diffusé. Ce champ peut être une liste de pays si plusieurs pays peuvent diffuser l'événement sportif. |
videoFormat |
Texte | La définition de la plus haute qualité compatible avec ce service de diffusion (par exemple,
|
contentToBeAnnounced |
Valeur booléenne | Obligatoire si applicable : utilisez cette propriété si le contenu est inconnu au moment de la création du flux. Définir sur true lorsque le fournisseur ne dispose pas d'informations à jour sur ce qui sera diffusé, 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 : utilisez cette propriété si aucun contenu n'est prévu pour la période. Nous vous recommandons vivement d'inclure au moins l'un des éléments suivants dans une entité BroadcastEvent :
|
isLiveBroadcast |
Valeur booléenne | Définissez cette valeur sur true si l'événement est en direct (par exemple, un événement sportif ou un concert). |
potentialAction |
WatchAction | Obligatoire si applicable : 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 diffusé. Pour en savoir plus, consultez la section Propriétés d'identifiant.
|
contentRating |
Text ou Rating | Obligatoire pour les contenus réservés aux adultes, fortement recommandé dans le cas contraire Pourquoi ? - Classification globale du contenu de la diffusion. Si la classification du contenu est indiquée 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 du contenu. Les valeurs acceptées sont : D, FV, L, S et V. D = Dialogue, FV = Violence fantastique, L = Langue, S = Contenu sexuel, V = Violence. |
Exemples
Un épisode de série TV est diffusé sur la chaîne de télévision Exemple 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": "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) n'est pas diffusée entre 12h et 20h et diffuse une émission intitulée My favorite show entre 20h et 12h:
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
Pour en savoir plus sur ces propriétés, consultez les pages suivantes: