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

Esta seção fornece os detalhes das propriedades da marcação de conteúdo para o Tipo de entidade MediaService que captura a configuração da sua ação de mídia integração

Tabela de especificações

Propriedade Tipo esperado Descrição
@type Texto

Obrigatório: sempre defina como MediaService.

@context Texto

Obrigatório: sempre defina 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:

  • Ele é globalmente exclusivo em todo o seu catálogo.
  • Ele é estático. O ID precisa ser estável e não pode mudar ao longo do tempo.
  • Ele está no formato Unified Resource Identifier (URI).
  • O domínio precisa ser da 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 um exemplo disso, consulte o exemplo do MediaService.

brandIcon ImageObject

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

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

  • É um arquivo PNG.
  • O plano de fundo é transparente.
  • Seu formato é redondo por natureza.
  • Verifique se as imagens estão suavizadas e não distorcidas/pixeladas

Essa propriedade deve ser repetida, pois você deve fornecer cinco imagens, uma para cada seguintes dimensões:

  • 16 x 16 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

Requisito adicional para integrações do Google TV: estas imagens da sua marca será exibido na parte superior do Guia de programação, nos botões de ação "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 resolução de 512 x 512 px, proporção 1:1)
  • Um ícone de marca nominativa branco no formato de arquivo PNG. (a maior resolução disponível, sem preferência por proporção)
  • Um ícone de marca nominativa colorido no formato de arquivo PNG. (a maior resolução disponível, sem preferência por proporção)

Verifique se as imagens estão suavizadas e não distorcidas/pixeladas.

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 da imagem e define seu respectivo aos 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, que é adequado para uso em fundo escuro.
  • forLightBackground:uma imagem, normalmente um ícone transparente, que é adequado para uso em fundo claro.
application SotfwareApplication

Obrigatório se aplicativos iOS, Android, Google Cast ou AndroidTV forem fornecidos: é a lista dos apps da sua marca nos seguintes itens:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.@type Texto

Obrigatório: sempre defina 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, você precisa especifique-o como o link para seu aplicativo na App Store e na Play Store.

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

application.installUrl URL

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

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

application.identifier

Texto

Obrigatório se aplicável: para plataformas que correspondem a uma das seguintes opções , defina-o de acordo. Caso contrário, esta propriedade não é obrigatória:

  • iOS::o identificador do aplicativo da 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: sempre defina como Organization.

parentOrganization.name Texto

Obrigatório: o nome da organização.

subscriptions MediaSubscription

Opcional: a lista de MediaSubscriptions disponíveis suportado pelo provedor do relógio.

baseSubscriptionTier MediaSubscription

Obrigatório, se aplicável: se um provedor de relógio e o provedor tiverem uma base pacote de assinatura, defina-o como a instância de assinatura para o conteúdo disponível para todos os assinantes. Caso contrário, essa propriedade não é obrigatória.

userRequestsFulfilledBy Texto

Opcional: defina como uma das partes a seguir que atendem ao usuário solicitações:

  • 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. do Google Cloud. Basicamente, o provedor retorna o link direto para o conteúdo solicitado ou inicia a reprodução diretamente nos dispositivos.

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

mediaOffered Texto

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

  • ["VoD"]: o provedor inclui somente conteúdo de vídeo on demand (VoD) no se alimentam. O conteúdo de VoD inclui Filmes e Programas de TV.
  • ["LiveTV"]: o provedor inclui somente TV ao vivo, o que inclui Canais e BroadcastEvent conteúdo no feed.
  • ["VoD", "LiveTV"]: o provedor inclui conteúdo de VoD e TV ao vivo em do feed.
  • ["Music"]: o provedor inclui apenas entidades de música no feed. Isso inclui Álbum, artistas, músicas e Playlist conteúdo.
  • ["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 álbum, artistas, músicas, Playlist, e Estação de rádio conteúdo.
.

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"
      }
    }
  ]
}