Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per il tipo di entità BroadcastEvent. Per comprendere meglio la relazione tra questi tipi, esamina i concetti relativi agli eventi TV in diretta.
Tabella delle specifiche di BroadcastEvent
| Proprietà | Tipo previsto | Descrizione |
|---|---|---|
@context |
Testo | Obbligatorio: sempre impostato su ["http://schema.org", {"@language": "xx"}]
|
@type |
Testo | Obbligatorio: sempre impostato su BroadcastEvent. |
@id |
URL | Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.@id deve soddisfare i seguenti requisiti:
url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore. |
name |
Testo | Obbligatorio: il titolo del programma o dell'evento. |
description |
Testo | La descrizione dello spettacolo o dell'evento. Limite di 300 caratteri. Utilizza un array per includere le descrizioni in più lingue e lunghezze. |
startDate |
Data | Obbligatorio: l'ora di inizio dell'evento nel formato ISO 8601 con il fuso orario. |
endDate |
Data | L'ora di fine dell'evento nel formato ISO 8601 con il fuso orario. |
publishedOn |
BroadcastService | Obbligatorio se applicabile: specifica l'entità BroadcastService che trasmette questo programma o evento.Se i contenuti vengono trasmessi su un canale TV, questa proprietà è obbligatoria. Se i contenuti non sono associati ad alcun canale TV, non fornire questa proprietà. |
publishedOn.@type |
Testo | Da impostare su BroadcastService. |
publishedOn.@id |
URL | Il @id dell'entità BroadcastService che trasmette questo programma o evento. |
workPerformed |
CreativeWork | Obbligatorio se applicabile: utilizza questa proprietà quando i contenuti sono uno dei seguenti tipi di entità: Movie, TVSeries e TVEpisode.È consigliabile che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
|
workPerformed.@type |
Testo | Impostato su Movie, TVSeries o TVEpisode. |
workPerformed.@id |
URL | Il @id dell'entità dei contenuti. |
broadcastOfEvent |
SportsEvent | Obbligatorio se applicabile: utilizza questa proprietà se i contenuti sono un evento dal vivo:
Ti consigliamo vivamente di includere almeno uno dei seguenti elementi in un'entità BroadcastEvent:
|
broadcastOfEvent.@type |
Testo | Da impostare su SportsEvent. |
broadcastOfEvent.@id |
URL | Il @id dell'entità evento. L'entità evento deve esistere nel feed e avere un @id diverso da quello di BroadcastEvent. |
location |
Text o Country | Obbligatorio se BroadcastEvent riguarda un evento sportivo, ovvero ha la proprietà broadcastOfEvent: il paese in cui può essere trasmesso l'evento sportivo sottostante. Questo campo può essere un elenco di paesi se più paesi possono trasmettere l'evento sportivo. |
videoFormat |
Testo | La definizione di qualità più elevata supportata su questo servizio di trasmissione, ad esempio
|
contentToBeAnnounced |
Valore booleano | Obbligatorio se applicabile: utilizza questa proprietà se il contenuto non è noto al momento della creazione del feed. Imposta il valore su true quando il fornitore non dispone di informazioni aggiornate su ciò che verrà trasmesso, false in caso contrario.È consigliabile che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
|
offAir |
Valore booleano | Obbligatorio se applicabile: utilizza questa proprietà se non è prevista la trasmissione di contenuti per la fascia oraria. È consigliabile che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
|
isLiveBroadcast |
Valore booleano | Imposta su true se si tratta di un evento dal vivo, ad esempio un evento sportivo o un concerto. |
potentialAction |
WatchAction | Obbligatorio se applicabile: se i contenuti vengono trasmessi come evento di live streaming senza canale (con contentToBeAnnounced impostato su false o offAir impostato su false) , utilizza questa proprietà per fornire il link diretto dell'evento. |
identifier |
PropertyValue | ID esterno che identifica i contenuti di trasmissione. Per i dettagli, consulta la sezione Proprietà identificatore.
|
contentRating |
Text o Rating | Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti Perché? Classificazione complessiva dei contenuti della trasmissione. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti:
|
contentRating.author |
Organizzazione | Obbligatorio se contentRating utilizza Rating: il nome dell'agenzia di classificazione. |
contentRating.ratingValue |
Testo | Obbligatorio se contentRating utilizza Rating: il valore della classificazione. |
contentRating.advisoryCode |
Testo | Il codice di avvertenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogue, FV = Fantasy Violence , L = Language, S = Sexual Content, V = Violence. |
Esempi
Una puntata TV viene trasmessa sul canale televisivo Example TV
(BroadcastService) tra le 21:00 e le 21:30 del 12 ottobre 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"
}
]
}
}
}
Esempio che mostra l'utilizzo della proprietà contentToBeAnnounced quando i contenuti da
trasmettere sull'emittente televisiva Example TV
(BroadcastService) tra le 21:00 e le 21:30 del 12 ottobre 2019 non sono noti
al momento della creazione del feed:
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"
}
]
}
}
}
L'emittente televisiva Example TV(BroadcastService) non trasmette
tra le 12:00 e le 20:00 e trasmette un programma chiamato My favorite show tra le 20:00
e le 12:00:
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"
}
]
}
}
}
Pagine correlate
Consulta le seguenti pagine per gli argomenti correlati a queste proprietà: