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 do BroadcastService

Propriedade Tipo esperado Descrição
@context Texto Obrigatório - sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
@type Texto Obrigatório: defina sempre 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 em seu catálogo
  • Estático; o ID deve ser estável e não deve mudar com o tempo (mesmo se a propriedade do URL do programa mudar). Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • na forma de um Identificador de Recursos unificados (URI)
  • O domínio usado para o valor @id deve pertencer à sua organização.
Como o url de uma entidade atende a todos os requisitos como um identificador, recomendamos que você use o url de uma entidade 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. É opcional para um serviço oferecido por cabo/satélite/over over the air (OTA). O Google usa este URL para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google.
url deve atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico que o Google possa rastrear.
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 em 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 veem nos guias do programa etc. O valor pode ser o mesmo que o valor do nome.
callSign Texto O indicativo de chamada oficial emitido pelo governo para o serviço de transmissão.
inLanguage Text ou Language Altamente recomendado Por quê? O idioma de transmissão principal 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 maiores ou barras podem ser usadas para indicar informalmente uma hierarquia de categorias. Por exemplo, Esportes, Esportes > Futebol, Notícias, Filme, Música, Documentário.
contentRating Texto ou Classificação Obrigatório para um serviço de transmissão somente para adultos: a classificação mais restritiva para a transmissão de conteúdo no canal. Se a classificação do conteúdo for fornecida na forma de uma string de texto, a agência de avaliação precisará incluir o espaço em branco antes dela. Por exemplo, uma classificação "TV-Y" da agência "TVPG" nos EUA é descrita como "TVPG TV-Y". Veja a lista de agências.
contentRating.author Texto ou 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 consultivo do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência de fantasia , 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 comprimentos 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 chave do 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 países.
  • Use uma matriz para representar várias áreas.
  • Não misture País, Estado, Cidade com GeoShape.
  • logo ImageObject Obrigatório se estiver integrado ao GoogleTV. Altamente recomendado, do contrário, Por quê? Uma imagem que representa este 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 plano de fundo transparente com um logotipo colorido ou branco, que seja claramente visível em um fundo escuro.
    • A imagem do logotipo deve aderir à proporção de 1:1, 4:3 ou 16:9 (nessa ordem de preferência) e deve ter uma resolução de 80 x 80 pixels 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.
    • O preenchimento no comprimento ou na largura (mas não em ambos) é aceitável se for adicionado para manter a proporção.
    • Consulte a seção Imagem para ver outros requisitos e especificações.
    Veja o 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.
    • "2K" para resolução de 2K.
    • "4K" para resolução 4K.
    • "8K" para resolução de 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 este serviço de transmissão ou para a organização a que esse serviço de transmissão pertence.
    broadcastAffiliateOf.@id Texto Obrigatório: defina como @id da rede de TV.
    broadcastAffiliateOf.@type Texto Obrigatório: defina sempre como Organization.
    identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica essa entidade, como _PARTNER_ID_. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
    popularityScore Pontuação de popularidade Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros sinais, para determinar qual mídia deve ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente entre os feeds, entre todas as entidades do seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
    popularityScore.@type Texto Sempre definido 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 mais popularidade.
    popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for globalmente aplicável, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
    Note: A popularidade específica por 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 definido como ["http://schema.org", {"@language": "xx"}]
    • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
    @type Texto Obrigatório: defina sempre 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 em seu catálogo
    • Estático
    • na forma de um Identificador de Recursos unificados (URI)
    Como o url de uma entidade atende a todos os requisitos como um identificador, recomendamos que você use o url de uma entidade 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 em 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 na qual 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, a ExampleTV é a provedora 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: defina sempre como Organization.
    identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica essa entidade, como um ID TMS da Gracenote para o 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 serviço de TV a cabo ou por 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):

    {
      "@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 do TelevisionChannel

    Propriedade Tipo esperado Descrição
    @context Texto Obrigatório - sempre definido como ["http://schema.org", {"@language": "xx"}]
    • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
    @type Texto Obrigatório: defina sempre 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 em seu catálogo
    • Estático
    • na forma de um Identificador de Recursos unificados (URI)
    Como o url de uma entidade atende a todos os requisitos como um identificador, recomendamos que você use o url de uma entidade 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 a cabo, por satélite ou de Internet.
    • Nos EUA, normalmente é um número de TV a cabo ou por satélite.
    • Para um serviço de Internet TV (por exemplo, um vMVPD), forneça o nome do canal.
    channelOrder Número Obrigatório para o Google TV (opcional): use esta propriedade para indicar a ordem em que os canais devem ser exibidos no guia de programação eletrônico para integrações do Google TV.

    O channelOrder precisa ser único em todos os canais no feed e começar de 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 com uma assinatura básica.
    • Premium para os canais que exigem pagamento acima da assinatura básica.
    Use uma matriz para fornecer vários valores.
    inBroadcastLineup CableOrSatelliteService (link em inglês) Obrigatório: o @id do CableOrSatelliteService que fornece este canal aos espectadores.
    providesBroadcastService BroadcastService (em inglês) Obrigatório: o @id do BroadcastService com a programação que este canal fornece.

    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 definido como ["http://schema.org", {"@language": "xx"}]
    • Em que "xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
    @type Texto Obrigatório: defina sempre 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 em seu catálogo
    • Estático
    • na forma de um Identificador de Recursos unificados (URI)
    Como o url de uma entidade atende a todos os requisitos como um identificador, recomendamos que você use o url de uma entidade como @id. Consulte a seção Identificador para mais detalhes.
    name Texto Obrigatório: o nome da rede de TV, provedor de conteúdo de TV ou operadora de TV.
    • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo em 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 comprimentos diferentes.
    sameAs URL Altamente recomendado Por quê? Um URL para uma página da Wikipédia que possa identificar a rede de TV. Ele precisa ser diferente da propriedade de URL. Preencha apenas com a página da Wikipédia que fale sobre um único canal/entidade de rede. As páginas da Wikipédia podem usar a terminologia "canal".
    potentialAction WatchAction Obrigatório, se aplicável: obrigatório se você tiver vários canais (BroadcastService) que se referem à 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 este 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 ID que identifica essa entidade, como um ID de TMS para a organização. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
    popularityScore Pontuação de popularidade Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros sinais, para determinar qual mídia deve ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente entre os feeds, entre todas as entidades do seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
    popularityScore.@type Texto Sempre definido 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 mais popularidade.
    popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for globalmente aplicável, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
    Note: A popularidade específica por 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 ver os tópicos relacionados a essas propriedades: