Propriedades de marcação de conteúdo de eventos de TV ao vivo

Esta seção fornece 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, revise os conceitos de Eventos de TV ao vivo.

Tabela de especificação de BroadcastEvent

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definir como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código de idioma da entidade no formato formato BCP 47, por exemplo, "en".
@type Texto Obrigatório: sempre definido como BroadcastEvent.
@id URL Obrigatório: é o identificador do conteúdo no formato de URI, por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o seu catálogo
  • Estático: o ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade do URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • na forma de um identificador de recurso unificado (URI, na sigla em inglês);
  • O domínio usado para o valor @id precisa pertencer à sua organização.
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url dela como @id. 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. Limista de 300 caracteres. Use uma matriz para incluir as descrições em vários idiomas e tamanhos.
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 destes itens:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced teve o endereço definido como true
  • offAir teve o endereço definido como true
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:
  • Para um evento esportivo, essa propriedade precisa se referir a uma entidade SportsEvent.

É altamente recomendável que uma entidade BroadcastEvent inclua pelo menos um destes elementos:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced teve o endereço definido como true
  • offAir teve o endereço definido como true
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 do BroadcastEvent.
location Texto ou País Obrigatório se BroadcastEvent for um SportsEvent, ou seja, tiver a propriedade broadcastOfEvent: o país onde o SportsEvent subjacente pode ser transmitido. Esse campo pode ser uma lista de países se vários países puderem transmitir o SportsEvent.
videoFormat Texto A definição de qualidade mais alta com suporte neste serviço de transmissão, por exemplo,
  • "SD" para definição padrão.
  • “HD” para alta definição.
  • "2K" para resolução 2K.
  • "4K" para resolução 4K.
  • "8K" para resolução de 8K.
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 ou false, caso contrário.
É altamente recomendável que uma entidade BroadcastEvent inclua pelo menos um destes elementos:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced teve o endereço definido como true
  • offAir teve o endereço definido como true
offAir Booleano Obrigatório se aplicável: use essa propriedade se não houver transmissão de conteúdo planejada para o horário.
É altamente recomendável que uma entidade BroadcastEvent inclua pelo menos uma destas opções:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced teve o endereço definido como true
  • offAir teve o endereço definido como true
isLiveBroadcast Booleano Defina como true se for um evento ao vivo, por exemplo, um evento esportivo ou um show.
potentialAction WatchAction Obrigatório se aplicável: se o conteúdo for transmitido como um canal que menos evento de transmissão ao vivo (com contentToBeAnnounced definido como false ou offAir definido como false) , use essa propriedade para fornecer o link direto do evento.
identifier PropertyValue ID externo que identifica o conteúdo da transmissão. Consulte a seção Propriedades do identificador para mais detalhes.
  • Observação: o tipo de entidade BroadcastEvent aceita apenas valores propertyID de TMS_ID ou TMS_ROOT_ID.
  • Essa propriedade só é fornecida nos casos em que uma entidade Movie, TVSeries, TVEpisode ou SportsEvent de nível superior totalmente formada não é referenciada usando a propriedade workPerformed ou broadcastOfEvent.
  • O valor da propriedade precisa refletir o TMS_ID ou o TMS_ROOT_ID da entidade Movie, TVSeries, TVEpisode ou SportsEvent que você deveria usar a propriedade workPerformed ou broadcastOfEvent.
  • TMS_ID tem preferência sobre o valor TMS_ROOT_ID.
contentRating Text ou Rating Obrigatório para conteúdo adulto. Caso contrário, é altamente recomendado. Por quê? - classificação geral do conteúdo transmitido. Se a classificação do conteúdo for feita na forma de uma string de texto, duas variações serão aceitas:
  • A agência de classificação anexada à classificação com um espaço em branco no meio. Por exemplo, uma classificação "PG-13" da agência "MPAA" nos EUA deve ser descrita como "MPAA PG-13". Consulte a lista de agências.
  • Um valor de "CLASSIFICAÇÃO NÃO CONHECIDA" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do Filme.
contentRating.author Text ou Organization Obrigatório se o contentRating usar Rating: o nome da agência de classificação.
contentRating.ratingValue Texto Obrigatório se o contentRating usar Rating: o valor da classificação.
contentRating.advisoryCode Texto O código consultivo para o conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = Diálogo, FV = Violência fantástica , 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 de 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 de 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": "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 de televisão Example TV(BroadcastService) está fora do ar entre 12h e 20h e transmite um programa chamado My favorite show entre 20h e 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"
        }
      ]
    }
  }
}

Confira as páginas a seguir para ver os tópicos relacionados a essas propriedades: