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, consulte os conceitos de canais de TV ao vivo.

Tabela de especificação 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 precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que a legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre definido como BroadcastService.
@id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo
  • Estáticas: 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 funcional.
  • No formato de identificador de recurso unificado (URI)
  • O domínio usado para o valor @id precisa ser de propriedade da sua organização.
Como o url de uma entidade atende a todos os requisitos como 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 transmitido por cabo/satélite/TV aberta. O Google usa esse URL para corresponder o conteúdo do seu feed ao conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • O url precisa conter um URL canônico que funcione e que o Google possa rastrear.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto alvo.
name Texto Obrigatório: o nome da rede.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo de 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 podem ver em guias de programas etc. O valor pode ser o mesmo do nome.
callSign Texto O indicativo oficial do serviço de transmissão emitido pelo governo.
inLanguage Text ou Language 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. Os sinais maiores ou barras podem ser usados 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 de TV exclusivo para adultos: classificação mais restritiva para o conteúdo transmitido no canal. Se a classificação do conteúdo for fornecida na forma de uma string de texto, a agência de classificação precisa ser adicionada à classificação com espaço em branco entre elas. Por exemplo, uma classificação "TV-Y" da agência "TVPG" nos EUA é descrita como "TVPG TV-Y". Consulte a lista de agências.
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.
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 com diferentes comprimentos.
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 troca de canal for realizada pelo provedor de serviços de TV. É a área em que os usuários podem 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 e Cidade com GeoShape.
  • logo ImageObject Obrigatório se a integração for com o GoogleTV. Altamente recomendado Por quê? Uma imagem que representa esse serviço de transmissão.
    • As integrações do GoogleTV exigem um logotipo que possa ser usado em um fundo escuro. O plano de fundo precisa ser transparente e o logotipo precisa ser colorido ou branco, de forma que fique claramente visível em um plano de fundo escuro.
    • A imagem do logotipo precisa 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 será usado.
    • O padding no comprimento ou na largura (mas não em ambos) é aceitável se adicionado para manter a proporção.
    • Consulte a seção Imagem para ver outros requisitos e especificações.
    Confira 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 da marcação de ação para mais detalhes.
    videoFormat Texto A definição de maior qualidade com suporte para esse 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 8K.
    broadcastTimezone Texto O fuso horário desse serviço de transmissão no formato IANA, por exemplo, America/Los_Angeles. Use uma matriz para várias zonas horárias.
    broadcastAffiliateOf Organização Obrigatório: a rede de TV que fornece a programação para esse serviço de transmissão ou a organização a que esse serviço pertence.
    broadcastAffiliateOf.@id Texto Obrigatório: defina como @id da rede de TV.
    broadcastAffiliateOf.@type Texto Obrigatório: sempre definido 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 PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia 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 nos feeds e entre todas as entidades no seu 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. Quanto maior a pontuação, maior a popularidade.
    popularityScore.eligibleRegion País Regiões em que esse índice 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 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 do 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 precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que a legenda/dublagem esteja em inglês.
    @type Texto Obrigatório: sempre definido como CableOrSatelliteService.
    @id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
    @id precisa atender aos seguintes requisitos:
    • Exclusivo globalmente no seu catálogo
    • Estático
    • No formato de identificador de recurso unificado (URI)
    Como o url de uma entidade atende a todos os requisitos como 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. Consulte o exemplo de 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 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 definido como Organization.
    identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica essa 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 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 virtual multicanal (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 precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que a legenda/dublagem esteja em inglês.
    @type Texto Obrigatório: sempre definido como TelevisionChannel.
    @id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
    @id precisa atender aos seguintes requisitos:
    • Exclusivo globalmente no seu catálogo
    • Estático
    • No formato de identificador de recurso unificado (URI)
    Como o url de uma entidade atende a todos os requisitos como 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 esse BroadcastService pode ser identificado como um serviço de TV a cabo, por satélite ou pela Internet.
    • Nos EUA, esse número geralmente é de TV a cabo ou por satélite.
    • Para um serviço de TV pela Internet (por exemplo, um vMVPD), informe o nome do canal.
    channelOrder Número Obrigatório para GoogleTV, opcional de outra forma: use essa propriedade para indicar a ordem em que os canais devem ser exibidos no guia de programação eletrônica para integrações do Google TV.

    O channelOrder precisa ser exclusivo entre os canais no feed e, de preferência, 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 exigem assinaturas.
    • Standard para os canais incluídos em uma assinatura básica.
    • Premium para os canais que exigem um pagamento além da assinatura básica.
    Use uma matriz para fornecer vários valores.
    inBroadcastLineup CableOrSatelliteService Obrigatório: o @id do CableOrSatelliteService que fornece esse canal aos espectadores.
    providesBroadcastService BroadcastService Obrigatório: o @id do BroadcastService cuja programação é fornecida por este canal.

    Exemplos de TelevisionChannel

    Exemplo de 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 de 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 precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que a legenda/dublagem esteja em inglês.
    @type Texto Obrigatório: sempre definido como Organization.
    @id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
    @id precisa atender aos seguintes requisitos:
    • Exclusivo globalmente no seu catálogo
    • Estático
    • No formato de identificador de recurso unificado (URI)
    Como o url de uma entidade atende a todos os requisitos como 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, do provedor de conteúdo de TV ou do operador de TV.
    • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo de 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 com diferentes comprimentos.
    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 "url". Preencha apenas com a página da Wikipedia que fala sobre uma única entidade de canal/rede. As páginas da Wikipedia podem usar a terminologia "canal".
    potentialAction WatchAction Obrigatório se aplicável: é necessá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 da 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 ID que identifica essa entidade, como um ID do TMS para essa 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 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 nos feeds e entre todas as entidades no seu 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. Quanto maior a pontuação, maior a popularidade.
    popularityScore.eligibleRegion País Regiões em que esse índice 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 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: