Questa sezione fornisce i dettagli sulle proprietà del markup dei contenuti per il tipo di entità BroadcastEvent. Per comprendere meglio la relazione tra questi tipi di eventi, consulta i concetti relativi agli eventi TV in diretta.
Tabella delle specifiche 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 il 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 del programma o dell'evento. Limista 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 fuso orario. |
endDate |
Data | L'ora di fine dell'evento nel formato ISO 8601 e 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 | @id dell'entità BroadcastService che trasmette questo programma o evento. |
workPerformed |
CreativeWork | Obbligatorio se applicabile: utilizza questa proprietà quando i contenuti rientrano in uno dei seguenti tipi di entità: Movie, TVSeries e TVEpisode.È vivamente consigliato che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
|
workPerformed.@type |
Testo | Imposta il valore su Movie, TVSeries o TVEpisode. |
workPerformed.@id |
URL | Il @id dell'entità di contenuti. |
broadcastOfEvent |
SportsEvent | Obbligatorio, se applicabile: utilizza questa proprietà se i contenuti sono un evento dal vivo:
È vivamente consigliato che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
|
broadcastOfEvent.@type |
Testo | Da impostare su SportsEvent. |
broadcastOfEvent.@id |
URL | Il valore @id dell'entità evento. L'entità evento deve esistere nel feed e ha un valore @id diverso da quello di BroadcastEvent. |
location |
Testo o Paese | Obbligatorio se BroadcastEvent è per un evento SportsEvent, ovvero ha una 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 da questo servizio di trasmissione; ad esempio,
|
contentToBeAnnounced |
Valore booleano | Obbligatorio se applicabile: utilizza questa proprietà se i contenuti sono sconosciuti al momento della creazione del feed. Imposta questa opzione su true quando il fornitore non dispone di informazioni aggiornate su ciò che verrà trasmesso, false altrimenti.È consigliabile che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
|
offAir |
Valore booleano | Obbligatorio, se applicabile: utilizza questa proprietà se non è prevista alcuna trasmissione di contenuti per la fascia oraria. È consigliabile che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
|
isLiveBroadcast |
Valore booleano | Imposta 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 un evento con meno live streaming per un 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 della trasmissione. Per maggiori dettagli, consulta la sezione Proprietà degli identificatori.
|
contentRating |
Testo o Valutazione | Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti Perché? - Classificazione complessiva dei contenuti dei contenuti trasmessi. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti:
|
contentRating.author |
Testo oppure Organizzazione | Obbligatorio se contentRating utilizza Rating: il nome dell'agenzia di valutazione. |
contentRating.ratingValue |
Testo | Obbligatorio se contentRating utilizza Rating: il valore della valutazione. |
contentRating.advisoryCode |
Testo | Il codice di consulenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogue, FV = Violenza di fantasia, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza. |
Esempi
Un episodio TV viene trasmesso sulla rete televisiva 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 sulla rete televisiva TV di esempio
(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"
}
]
}
}
}
Rete televisiva TV di esempio(BroadcastService) Il canale è non trasmesso
tra le 12:00 e le 20:00 e trasmette 1 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à: