Propriedades de marcação de conteúdo do MediaService (obrigatório)

Esta seção fornece os detalhes das propriedades de marcação de conteúdo para o tipo de entidade MediaService que capturam a configuração da sua integração de Ações de mídia.

Tabela de especificações

Propriedade Tipo esperado Descrição
@type Texto

Obrigatório: defina sempre como MediaService.

@context Texto

Obrigatório: defina sempre como ["http://schema.org", {"@language": "xx"}].

@id URL

Obrigatório: um identificador exclusivo para sua marca, por exemplo, https://example.com.

O identificador precisa atender aos seguintes requisitos:

  • É exclusivo globalmente em seu catálogo.
  • É estático. O ID precisa ser estável e não pode mudar ao longo do tempo.
  • Ele está no formato Identificador de Recursos unificados (URI).
  • O domínio precisa pertencer à sua organização.
name Texto

Obrigatório: o nome do provedor.

Se a marca tiver nomes específicos de localidade, liste-os em uma matriz. Para ver um exemplo, consulte o exemplo do MediaService.

brandIcon ImageObject

Obrigatório para todas as ações de assistir e ouvir: o arquivo de imagem do ícone da sua marca, repetido para cada tamanho. No resultado da ação de assistir/ouvir, o Google associa os links diretos do conteúdo ao ícone da marca.

O arquivo de imagem do ícone da sua marca precisa atender aos seguintes requisitos:

  • É um arquivo PNG.
  • O plano de fundo é transparente.
  • O formato dele é arredondado.
  • Verifique se as imagens estão com suavização e não estão distorcidas/pixeladas

Essa propriedade precisa ser repetida, porque é necessário fornecer cinco imagens, uma para cada uma das seguintes dimensões:

  • 16x16 pixels, com um arquivo de até 1 KB
  • 20 x 20 pixels, com um arquivo de até 1 KB
  • 40 x 40 pixels, com um arquivo de até 1 KB
  • 44 x 44 pixels, com um arquivo de até 1 KB
  • 112 x 112 pixels, com um arquivo de até 3 KB

Outros requisitos para integrações com o Google TV: essas imagens do ícone da sua marca serão exibidas na parte superior do Guia de programação, nos botões de ação de assistir e nas configurações do Google TV. Forneça três ícones que atendam aos seguintes requisitos:

  • Um ícone quadrado no formato de arquivo PNG. (com uma resolução de 512x512 px, proporção de 1:1)
  • Um ícone branco de marca nominativa no formato de arquivo PNG. (a resolução mais alta disponível, sem preferência para a proporção)
  • Um ícone colorido de marca nominativa no formato de arquivo PNG. (a resolução mais alta disponível, sem preferência para a proporção)

Verifique se as imagens estão com suavização e não estão distorcidas/pixelizadas.

brandIcon.contentURL URL

Obrigatório: é o URL da imagem.

brandIcon.height Número

Obrigatório: é a altura da imagem em pixels.

brandIcon.width Número

Obrigatório: é a largura da imagem em pixels.

brandIcon.additionalProperty PropertyValue

Obrigatório: a propriedade adicional usada para descrever o tipo de imagem e define os usos pretendidos.

brandIcon.additionalProperty.@type Texto

Obrigatório: defina como PropertyValue.

brandIcon.additionalProperty.name Texto

Obrigatório: defina como contentAttributes.

brandIcon.additionalProperty.value Texto

Obrigatório: a adequação do plano de fundo.

Para ser válido, defina pelo menos um dos seguintes valores:

  • forDarkBackground: uma imagem, normalmente um ícone transparente, adequada para uso em um fundo escuro.
  • forLightBackground: uma imagem, normalmente um ícone transparente, adequada para uso em um fundo claro.
application SotfwareApplication (em inglês)

Obrigatório se forem fornecidos aplicativos iOS, Android, Google Cast ou AndroidTV: a lista dos seus aplicativos de marca das seguintes maneiras:

  • iOS
  • Android
  • Transmissão
  • AndroidTV
application.@type Texto

Obrigatório: defina sempre como SoftwareApplication.

application.operatingSystem Texto

Obrigatório: defina como uma das seguintes opções:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl URL

Obrigatório, se aplicável: para as plataformas Android, AndroidTV e iOS, é necessário especificar isso como o link para seu aplicativo na App Store e na Play Store.

Para todas as outras plataformas, essa não é uma propriedade obrigatória.

application.installUrl URL

Obrigatório, se aplicável: se o provedor oferecer reprodução de mídia por meio de um app AndroidTV, especifique-o como o link para o arquivo APK da AndroidTV.

Se o provedor não oferecer a reprodução AndroidTV, essa propriedade não será obrigatória.

application.identifier

Texto

Obrigatório, se aplicável: para plataformas que correspondem a um dos seguintes valores, defina-o de acordo. Essa propriedade não é obrigatória:

  • iOS:o identificador do app na App Store. Por exemplo, 967093455.
  • Android:é o nome do pacote Android da Play Store. Por exemplo, com.abc.media.android.
  • Transmitir: o ID do app Google Cast. Por exemplo, ACDA4FDE.
  • AndroidTV:é o nome do pacote AndroidTV da Play Store. Por exemplo, com.abc.media.atv.android.
parentOrganization Organização

Obrigatório: o provedor pai do serviço.

parentOrganization.@type Texto

Obrigatório: defina sempre como Organization.

parentOrganization.name Texto

Obrigatório - O nome da organização.

subscriptions MediaSubscription

Opcional: a lista de MediaSubscriptions disponíveis compatíveis com o provedor de monitoramento.

baseSubscriptionTier MediaSubscription

Obrigatório, se aplicável: se um provedor de smartwatches e o provedor tiverem um pacote de assinatura básico, defina isso na instância de assinatura para conteúdo disponível a todos os assinantes. Essa propriedade não é obrigatória.

userRequestsFulfilledBy Texto

Opcional: defina como uma das seguintes partes que atende às solicitações do usuário:

  • Google: todas as solicitações são atendidas pelo Google. Basicamente, o Google retorna o link direto para o conteúdo solicitado.
  • Provider: todas as solicitações são atendidas pelo provedor de conteúdo, ou seja, o provedor do Cloud. Essencialmente, o provedor retorna o link direto para o conteúdo solicitado ou inicia a reprodução diretamente nos dispositivos.

Por padrão, esta propriedade é definida como Google.

mediaOffered Texto

Obrigatório: defina como uma das seguintes opções, que correspondem aos tipos de conteúdo do seu catálogo que estão incluídos no feed:

  • ["VoD"]: o provedor só inclui conteúdo de vídeo on demand (VoD) no feed. O conteúdo de VoD inclui filmes e programas de TV.
  • ["LiveTV"]: o provedor inclui somente TV ao vivo, que inclui conteúdo de Channels e BroadcastEvent no feed.
  • ["VoD", "LiveTV"]: o provedor inclui conteúdo de VoD e TV ao vivo no feed.
  • ["Music"]: o provedor só inclui entidades de música no feed. Isso inclui conteúdo de álbuns, artistas, músicas e playlists.
  • ["Radio"]: o provedor inclui apenas entidades Radio no feed.
  • ["Music", "Radio"]: o provedor inclui entidades de música e rádio no feed. Isso inclui conteúdo de álbuns, artistas, músicas, playlist e rádio.

Exemplo de MediaService

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": [
        "http://schema.org",
        {
          "@language": "en"
        }
      ],
      "@type": "MediaService",
      "@id": "https://abcmedia.com",
      "name": [
        {
          "@language": "en-us",
          "@value": "ABC Media"
        },
        {
          "@language": "en-gb",
          "@value": "ABC"
        }
      ],
      "userRequestsFulfilledBy": "Google",
      "mediaOffered": [
        "LiveTV",
        "VoD"
      ],
      "brandIcon": [
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
          "width": 16,
          "height": 16,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
          "width": 20,
          "height": 20,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
          "width": 40,
          "height": 40,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
          "width": 44,
          "height": 44,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
          "width": 112,
          "height": 112,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        }
      ],
      "application": [
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Android",
          "downloadUrl": "https://google.play.store/com.abc.media.android",
          "identifier": "com.abc.media.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "iOS",
          "downloadUrl": "https://apple.app.store/967093455",
          "identifier": "967093455"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "AndroidTV",
          "downloadUrl": "https://google.play.store/com.abc.media.atv.android",
          "installUrl": "https://abcmedia.com/path_to_apkfile.apk",
          "identifier": "com.abc.media.atv.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Cast",
          "identifier": "ACDA4FDE"
        }
      ],
      "subscriptions": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:basic"
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:premium"
        }
      ],
      "baseSubscriptionTier": {
        "@type": "MediaSubscription",
        "name": "Basic Package",
        "@id": "[partner determined string]",
        "identifier": "abcmedia.com:basic"
      },
      "parentOrganization": {
        "@type": "Organization",
        "name": "ABC Media"
      }
    }
  ]
}