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

Esta seção fornece os detalhes das propriedades de marcação de conteúdo para os tipos de entidade BroadcastService, CableOrSatelliteService, TelevisionChannel e Organization. Para entender melhor a relação entre esses tipos, revise os conceitos de Canais de TV ao vivo.

Tabela de especificações de BroadcastService

Propriedade Tipo esperado Descrição
@context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre defina como BroadcastService.
@id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo
  • Estático O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela como @id. Consulte a seção Identificador para mais detalhes.
url URL Obrigatório, se aplicável: é o URL canônico do serviço de transmissão se o canal estiver disponível para visualização na Internet. Ele é opcional para serviços prestados por cabo, satélite ou over the air (OTA). O Google usa esse URL para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google.
O url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico em funcionamento que possa ser rastreado pelo Google.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório: o nome da rede.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo Várias regiões e idiomas.
  • Apenas um nome é aceito por localidade (par de idioma e país).
broadcastDisplayName Texto Obrigatório: o nome de exibição da rede que os usuários normalmente encontram em guias de programas etc. O valor pode ser igual ao valor do nome.
callSign Texto O indicativo de chamada oficial emitido pelo governo do serviço de transmissão.
inLanguage Texto ou Idioma Altamente recomendado Por quê? O idioma principal de transmissão do canal. Use um dos códigos de idioma do padrão IETF BCP 47.
category Texto Altamente recomendado Por quê? Uma categoria para o item. Sinais ou barras maiores podem ser usados para indicar informalmente uma hierarquia de categoria. por exemplo, Esportes, Esportes > Futebol, notícias, filmes, músicas e documentários.`
contentRating Text ou Rating Obrigatório para um serviço de transmissão de TV somente para adultos: é a classificação mais restritiva para o conteúdo transmitido no canal. Se a classificação do conteúdo for dada na forma de uma string de texto, a agência precisa ser anexada ao início da classificação com um espaço em branco no meio. por exemplo, "TV-Y" classificação da agência "TVPG" nos EUA é descrito como "TVPG TV-Y". Consulte a lista de agências.
contentRating.author Text ou Organization 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 consultivo do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência fantasiosa, L = idioma, S = conteúdo sexual, V = violência.
description Texto Uma descrição do serviço de transmissão. Limite de 300 caracteres. Use uma matriz para fornecer as descrições em vários idiomas e/ou em tamanhos diferentes.
slogan Texto Um slogan do serviço de transmissão.
areaServed País, Estado, Cidade ou GeoShape Obrigatório, se aplicável: é obrigatório se a mudança de canal for atendida pelo provedor de serviços de TV: a área em que os usuários podem esperar receber o serviço de transmissão. Use o código de país ISO 3166-1 para especificar os países.
  • Use uma matriz para representar várias áreas.
  • Não misture País, Estado, Cidade com GeoShape.
  • logo ImageObject Obrigatório se integração com o Google TV. Altamente recomendado. Caso contrário, Por quê? Uma imagem que representa esse serviço de transmissão.
    • As integrações do Google TV exigem um logotipo que pode ser usado em um fundo escuro. Ela precisa ter um fundo transparente com um logotipo colorido ou branco que seja claramente visível em um fundo escuro.
    • A imagem do logotipo deve ter uma proporção de 1:1, 4:3 ou 16:9 (nessa ordem de preferência) e uma resolução de 80 x 80 px ou maior.
    • Use o valor forDarkBackground para o nome da propriedade personalizada contentAttributes como parte da propriedade additionalProperty para indicar o tipo de plano de fundo em que o logotipo deve ser usado.
    • Um padding de comprimento ou largura (mas não ambos) é aceitável se adicionado para manter a proporção.
    • Consulte a seção Imagem para outros requisitos e especificações.
    Confira um exemplo abaixo
    potentialAction WatchAction Obrigatório, se aplicável: um objeto de marcação de ação que fornece os detalhes da ação. Consulte as propriedades de marcação de ação para mais detalhes.
    videoFormat Texto A definição de qualidade mais alta suportada neste serviço de transmissão. por exemplo,
    • "SD" para definição padrão.
    • "HD" para alta definição.
    • "2 mil" para a resolução 2K.
    • "4K" para a resolução 4K.
    • "8 mil" para resolução 8K.
    broadcastTimezone Texto É o fuso horário deste serviço de transmissão no formato IANA. por exemplo, America/Los_Angeles. Use uma matriz para vários fusos horários.
    broadcastAffiliateOf Organização Obrigatório: a rede de TV que fornece programação para o serviço de transmissão ou a organização a que o serviço pertence.
    broadcastAffiliateOf.@id Texto Obrigatório: defina como @id da rede de TV.
    broadcastAffiliateOf.@type Texto Obrigatório: sempre defina como Organization.
    identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro que identifica essa entidade, como _PARTNER_ID_. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
    popularityScore PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
    popularityScore.@type Texto Sempre defina como PopularityScoreSpecification.
    popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. uma pontuação mais alta significa maior popularidade.
    popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
    Note: A popularidade específica da localidade tem precedência sobre a popularidade global (EARTH)

    Exemplo de BroadcastService

    {
        "@context": [
            "http://schema.org",
            {
                "@language": "en"
            }
        ],
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example-tv",
        "name": "EXAMPLE-TV",
        "broadcastDisplayName": "ABCD",
        "url": "http://example.com/stations/example-tv",
        "callSign": "EXA-TV",
        "videoFormat": "SD",
        "inLanguage": "en",
        "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"
            }
        ],
        "popularityScore": {
            "@type": "PopularityScoreSpecification",
            "value": 178,
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "US"
                }
            ]
        },
        "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",
                    "authenticator": {
                        "@type": "Organization",
                        "name": "TVE"
                    }
                },
                "eligibleRegion": [
                    {
                        "@type": "Country",
                        "name": "US"
                    }
                ]
            }
        },
        "logo": [
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Light",
                "contentUrl": "http://example.com/images/example-logo-light.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forLightBackground"
                        ]
                    }
                ]
            },
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Dark",
                "contentUrl": "http://example.com/images/example-logo-dark.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forDarkBackground"
                        ]
                    }
                ]
            }
        ]
    }
    

    Tabela de especificações de CableOrSatelliteService

    Propriedade Tipo esperado Descrição
    @context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
    • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
    @type Texto Obrigatório: sempre defina como CableOrSatelliteService.
    @id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
    @id precisa atender aos seguintes requisitos:
    • Exclusivo globalmente no seu catálogo
    • Estático
    • Na forma de URI (Identificador de recurso unificado)
    Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela como @id. Consulte a seção Identificador para mais detalhes.
    name Texto Obrigatório: o nome do serviço de TV.
    • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo Várias regiões e idiomas.
    • Apenas um nome é aceito por localidade (par de idioma e país).
    areaServed País, Estado, Cidade ou GeoShape Obrigatório: a área em que os usuários podem esperar receber o serviço de transmissão.
    provider Organização Obrigatório: o provedor pai do serviço, se aplicável. Por exemplo, ExampleTV é o provedor dos serviços regionais ExampleTV San Francisco e ExampleTV San Diego.
    provider.@id Texto Obrigatório: o ID do operador de TV.
    provider.@type Texto Obrigatório: sempre defina como Organization.
    identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro que identifica a entidade, como um ID do TMS da Gracenote para esse serviço de transmissão. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.

    Exemplos de CableOrSatelliteService

    Exemplo de um serviço via cabo ou satélite:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/provider-lineups/exampletv-san-francisco",
      "name":"ExampleTV San Francisco",
      "provider": {
        "@type": "Organization",
        "@id": "http://example.com/providers/exampletv"
      },
      "areaServed":[
        {
          "@type":"GeoShape",
          "@id": "http://example.com/area1"
        }
      ],
      "identifier": {
        "@type": "PropertyValue",
        "propertyID": "TMS_ID",
        "value": "12345"
      }
    }
    
    {
      "@type": "GeoShape",
      "@id": "http://example.com/area1",
      "addressCountry": "US",
      "postalCode": [
        "94118",
        "94119"
      ]
    }
    

    Exemplo de um distribuidor de programação de vídeo multicanal virtual (vMVPD, na sigla em inglês):

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/providers/my-online-example-tv",
      "name":"My Online Example TV",
      "provider": {
        "@type": "Organization",
        "@id": "http://my-online-tv.com"
      },
      "areaServed":[
        {
          "@type":"Country",
          "name": "US",
        },
        {
          "@type":"Country",
          "name": "CA",
        }
      ]
    }
    

    Tabela de especificações TelevisionChannel

    Propriedade Tipo esperado Descrição
    @context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
    • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
    @type Texto Obrigatório: sempre defina como TelevisionChannel.
    @id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
    @id precisa atender aos seguintes requisitos:
    • Exclusivo globalmente no seu catálogo
    • Estático
    • Na forma de URI (Identificador de recurso unificado)
    Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela como @id. Consulte a seção Identificador para mais detalhes.
    broadcastChannelId Texto Obrigatório: um identificador exclusivo pelo qual este BroadcastService pode ser identificado como um serviço de TV via cabo, satélite ou Internet.
    • Nos EUA, normalmente é um número para TV a cabo ou por satélite.
    • Para um serviço de TV pela Internet (por exemplo, um vMVPD), forneça o nome do canal.
    channelOrder Número Obrigatório para Google TV, opcional em outros casos: use essa propriedade para indicar a ordem em que os canais serão exibidos no guia de programação eletrônica para integrações do Google TV.

    O channelOrder precisa ser único em todos os canais no feed e, idealmente, deve começar em 1. channelOrder não pode ter um valor negativo ou 0.
    broadcastServiceTier Texto Use os seguintes valores:
    • Free para o canal que não requer inscrições.
    • Standard para os canais incluídos em uma assinatura básica.
    • Premium para os canais que exigem pagamento além da assinatura básica.
    Use uma matriz para fornecer diversos valores.
    inBroadcastLineup CableOrSatelliteService Obrigatório: o @id do CableOrSatelliteService que fornece o canal aos espectadores.
    providesBroadcastService BroadcastService Obrigatório: o @id do BroadcastService com a programação fornecida pelo canal.

    Exemplos de TelevisionChannel

    Exemplo de um canal de TV a cabo ou por satélite:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/exampleTV/example-tv-7",
      "broadcastChannelId":"7",
      "channelOrder": 1,
      "broadcastServiceTier":["Premium", "Standard"],
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/exampleTV-san-francisco"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/example-tv"
      }
    }
    

    Exemplo para um canal de TV on-line:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/my-online-example-tv/sport-channel",
      "broadcastChannelId":"sport-channel",
      "channelOrder": 3,
      "broadcastServiceTier":"Premium",
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/my-online-example-tv"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/sport-channel"
      }
    }
    

    Tabela de especificações da organização

    Propriedade Tipo esperado Descrição
    @context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
    • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
    @type Texto Obrigatório: sempre defina como Organization.
    @id URL Obrigatório: o identificador do conteúdo no formato URI. Por exemplo, https://example.com/1234abc.
    @id precisa atender aos seguintes requisitos:
    • Exclusivo globalmente no seu catálogo
    • Estático
    • Na forma de URI (Identificador de recurso unificado)
    Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela como @id. Consulte a seção Identificador para mais detalhes.
    name Texto Obrigatório: o nome da rede de TV, do provedor de conteúdo ou do operador de TV.
    • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo Várias regiões e idiomas.
    • Apenas um nome é aceito por localidade (par de idioma e país).
    description Texto Uma descrição da organização. Limite de 300 caracteres. Use uma matriz para fornecer as descrições em vários idiomas e/ou em tamanhos diferentes.
    sameAs URL Altamente recomendado Por quê? Um URL para uma página da Wikipédia que pode identificar a rede de TV. Precisa ser diferente da propriedade URL. Preencha apenas com uma página da Wikipédia que fale sobre uma única entidade de canal/rede. As páginas da Wikipédia podem usar a terminologia "canal".
    potentialAction WatchAction Obrigatório se aplicável: caso você tenha vários canais (BroadcastService) referenciando a Organização. Um objeto de marcação de ação que fornece os detalhes da ação. Consulte as propriedades de marcação de ação para mais detalhes.
    url URL O URL da organização. O Google usa esse URL para reconciliar com precisão essa organização com a organização nos bancos de dados do Google.
    identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro que identifica essa entidade, como um ID do TMS da organização. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
    popularityScore PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
    popularityScore.@type Texto Sempre defina como PopularityScoreSpecification.
    popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. uma pontuação mais alta significa maior popularidade.
    popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
    Note: A popularidade específica da localidade tem precedência sobre a popularidade global (EARTH)

    Exemplo de organização

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"Organization",
      "@id":"http://example.com/networks/abcd-network",
      "name":"ABCD",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "TMS_ID",
          "value": "12345"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "_PARTNER_ID_",
          "value": "exampletv-12345"
        }
      ],
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://example.com/networkstream",
          "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": "2050-10-21T10:35:29Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://example.com/subscription",
            "name": "ABCD",
            "sameAs": "http://example.com/subscription",
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            }
          ]
        }
      },
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 178,
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          }
        ]
      }
    }
    

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