Nesta seção, mostramos os detalhes das propriedades de marcação de conteúdo para o tipo de entidade BroadcastEvent. Para entender melhor a relação entre esses tipos, consulte os conceitos de eventos do LiveTV.
Tabela de especificações de BroadcastEvent
| Propriedade | Tipo esperado | Descrição |
|---|---|---|
@context |
Texto | Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
|
@type |
Texto | Obrigatório: sempre definido como BroadcastEvent. |
@id |
URL | Obrigatório: o identificador do slot de transmissão no formato de URI. Por exemplo, https://example.com/live/channel1/20191012T2100.@id precisa atender aos seguintes requisitos:
url em BroadcastEvent ou SportsEvent. Forneça o url canônico apenas na entidade de conteúdo subjacente (Movie, TVSeries ou TVEpisode). Consulte a seção Identificador para mais detalhes. |
name |
Texto | Obrigatório: o título do programa ou evento. |
description |
Texto | A descrição do programa ou evento. Limite de 300 caracteres. Use uma matriz para incluir descrições em vários idiomas (uma por idioma). |
startDate |
Data | Obrigatório: o horário de início do evento no formato ISO 8601 com fuso horário. |
endDate |
Data | É o horário de término do evento no formato ISO 8601 com fuso horário. |
publishedOn |
BroadcastService | Obrigatório, se aplicável: especifique a entidade BroadcastService que transmite esse programa ou evento.Se o conteúdo for transmitido em um canal de TV, essa propriedade será obrigatória. Se o conteúdo não estiver associado a nenhum canal de TV, não forneça essa propriedade. |
publishedOn.@type |
Texto | Defina como BroadcastService. |
publishedOn.@id |
URL | O @id da entidade BroadcastService que transmite esse programa ou evento. |
workPerformed |
CreativeWork | Obrigatório, se aplicável: use essa propriedade quando o conteúdo for um dos seguintes tipos de entidade: Movie, TVSeries e TVEpisode.É altamente recomendável que uma entidade BroadcastEvent inclua pelo menos um dos seguintes itens:
|
workPerformed.@type |
Texto | Defina como Movie, TVSeries ou TVEpisode. |
workPerformed.@id |
URL | O @id da entidade de conteúdo. |
broadcastOfEvent |
SportsEvent | Obrigatório, se aplicável: use essa propriedade se o conteúdo for um evento ao vivo:
É altamente recomendável que uma entidade BroadcastEvent inclua pelo menos um dos seguintes itens:
|
broadcastOfEvent.@type |
Texto | Defina como SportsEvent. |
broadcastOfEvent.@id |
URL | O @id da entidade do evento. A entidade do evento precisa existir no feed e ter um @id diferente de BroadcastEvent. |
location |
Texto ou País | Obrigatório se o BroadcastEvent for para um SportsEvent, ou seja, tiver a propriedade broadcastOfEvent: o país em que o SportsEvent pode ser transmitido. Precisa ser um código de país ISO 3166-1 alfa-2 em letras maiúsculas (por exemplo, "US" ou "CA"), fornecido como Text ou na propriedade name de um objeto Country. Use uma matriz para listar vários países.Exemplos: "location": "US" ou "location": {"@type": "Country", "name": "US"} |
videoFormat |
Texto | A definição de maior qualidade compatível com esse serviço de transmissão, por exemplo,
|
contentToBeAnnounced |
Booleano | Obrigatório, se aplicável: use essa propriedade se o conteúdo for desconhecido no momento da criação do feed. Defina como true quando o provedor não tiver informações atualizadas sobre o que será transmitido, false caso contrário.É altamente recomendável que uma entidade BroadcastEvent inclua pelo menos um dos seguintes:
|
offAir |
Booleano | Obrigatório se aplicável: defina como true quando não houver transmissão de conteúdo planejada para o horário em um canal BroadcastService.
BroadcastEvent inclua pelo menos um dos seguintes itens:
|
isLiveBroadcast |
Booleano | Defina como booleano true (sem aspas) se esta transmissão for uma transmissão ao vivo (por exemplo, um jogo de esportes ao vivo ou um noticiário diário ao vivo) ou false para programação não ao vivo e replays. |
potentialAction |
WatchAction | Obrigatório, se aplicável: nunca forneça potentialAction em um BroadcastEvent quando broadcastOfEvent fizer referência a um SportsEvent (coloque todos os links diretos de esportes em SportsEvent.potentialAction) ou quando publishedOn fizer referência a um canal BroadcastService (coloque os links diretos do canal em BroadcastService.potentialAction). Forneça BroadcastEvent.potentialAction apenas para transmissões ao vivo sem canal que não façam referência a um SportsEvent (como conteúdo extra independente ao vivo com contentToBeAnnounced e offAir omitidos ou false). |
identifier |
PropertyValue | ID externo que identifica o conteúdo da transmissão. Consulte a seção Propriedades do identificador para mais detalhes.
|
contentRating |
Texto ou Classificação | Obrigatório para conteúdo adulto, altamente recomendado para os demais Por quê? - Classificação geral do conteúdo transmitido. Se a classificação do conteúdo for fornecida na forma de uma string de texto, duas variações serão aceitas:
|
contentRating.author |
Organização | Obrigatório se contentRating usar Rating: o nome da agência de classificação. |
contentRating.ratingValue |
Texto | Obrigatório se contentRating usar Rating: o valor da classificação. |
contentRating.advisoryCode |
Texto | O código de aviso do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = Diálogo, FV = Violência de fantasia, L = Linguagem, S = Conteúdo sexual, V = Violência. |
Exemplos
Um episódio de TV é transmitido na rede de televisão Example TV
(BroadcastService) entre 21h e 21h30 em 12 de outubro de 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"
}
]
}
}
}
Exemplo que mostra o uso da propriedade contentToBeAnnounced quando o conteúdo a ser
transmitido na rede de televisão Example TV
(BroadcastService) entre 21h e 21h30 em 12 de outubro de 2019 não é conhecido
no momento da criação do feed:
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"
}
]
}
}
}
O canal da rede de televisão Example TV (BroadcastService) fica fora do ar entre 12h e 20h (modelado como dois blocos contíguos de 4 horas de Off Air) e transmite um programa chamado My favorite show entre 20h e 0h:
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"
}
]
}
}
}
Páginas relacionadas
Confira as páginas a seguir para ver os tópicos relacionados a essas propriedades: