Propriedades de imagem

Esta seção detalha as propriedades de marcação de conteúdo de image para filmes, programas de TV, transmissões de TV ao vivo e eventos esportivos. Essa marcação permite que os provedores descrevam o tipo de imagem, como se é um título, plano de fundo ou imagem icônica, e o uso sugerido.

Tabela de especificações

A propriedade image pode ser fornecida para os tipos de entidade Movie, TVSeries, TVSeason, TVEpisode, SportsEvent ou BroadcastEvent. A tabela a seguir descreve as propriedades disponíveis para a propriedade image. A propriedade additionalProperty inclui um nome de propriedade personalizada chamado contentAttributes, que contém uma matriz de valores que descrevem o tipo de imagem e o uso pretendido.

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como "http://schema.org".
@type Texto Obrigatório: sempre definido como ImageObject.
contentUrl URL Obrigatório: o URL da imagem.
additionalProperty PropertyValue Obrigatório: define a propriedade contentAttributes, que descreve o tipo de imagem e o uso pretendido. Para mais detalhes, leia contentAttributes.
character Person

Obrigatório, se aplicável: um personagem fictício associado à imagem. Isso é obrigatório se contentAttribute incluir castInCharacter.
inLanguage Texto Obrigatório, se aplicável: o idioma do texto usado na imagem. Use um dos códigos de idioma do padrão IETF BCP 47. Se a imagem incluir um contentAttribute de hasTitle, essa propriedade será obrigatória.
regionsAllowed Place Recomendado: as regiões em que a imagem é permitida. Se não for especificado, será considerado que a imagem é permitida em qualquer lugar. Especifique os países no formato ISO 3166.
datePublished Data

Obrigatório, se aplicável: data em que a imagem estará disponível, no formato ISO 8601 (incluindo o fuso horário).

  • A data pode ser definida no futuro.

Se houver restrições de tempo para o uso da imagem, essa propriedade será obrigatória se a imagem não puder ser exibida antes da data especificada. Se não houver essa restrição, ela poderá ser omitida. É necessário que a imagem correspondente seja fornecida no feed pelo menos sete dias antes da datePublished. Isso vai aumentar as chances de o conteúdo aparecer nas plataformas do Google no momento certo.

expires Data

Obrigatório, se aplicável: data em que a imagem não estará mais disponível, no formato ISO 8601 (incluindo o fuso horário).

  • Se o conteúdo estiver sempre disponível após a publicação, você poderá omitir essa propriedade.

É necessário que todas as atualizações na data de validade sejam feitas no feed pelo menos 7 dias antes da data de validade. Isso vai aumentar as chances de o conteúdo deixar de aparecer nas plataformas do Google na data de validade.

audience Público Recomendado: o público-alvo pretendido ou preferencial para essa imagem.
audience.geographicArea AdministrativeArea Recomendado: as regiões pretendidas ou preferidas para essa imagem. Por outro lado, use regionsAllowed para especificar restrições rígidas. Se audience.geographicArea não for especificado, vamos presumir que ele pode ser usado em qualquer lugar. Especifique os países no formato ISO 3166.
copyrightHolder Organization ou Person Recomendado: a parte que detém os direitos autorais da imagem.
keywords Texto Recomendado: palavras-chave ou tags usadas para descrever a imagem. É possível fornecer vários keywords usando uma matriz. Por exemplo, ["feature, biography"]
name Texto Recomendado: nome da imagem.
width Número inteiro Opcional: largura de número inteiro positivo da imagem em pixels (por exemplo, 1920). Não inclua strings de unidade, como "px".
height Número inteiro Opcional: altura da imagem em pixels como um número inteiro positivo (por exemplo, 1080). Não inclua strings de unidade, como "px".

contentAttributes

A propriedade contentAttributes de image descreve o tipo da imagem e define os usos sugeridos. As categorias na lista a seguir incluem os valores contentAttributes que os provedores precisam incluir em cada ImageObject.

Tipo

  • iconic: uma imagem ilustrativa que exemplifica o programa. Geralmente, uma renderização artística.
  • sceneStill: um trecho de imagem do programa.
  • castInCharacter: uma foto de um membro do elenco caracterizado como o personagem. Se você usar esse valor, inclua também a propriedade character para identificar o personagem específico na imagem. Se houver vários personagens, como em um elenco, inclua várias propriedades character como uma matriz.
  • logo: a imagem contém apenas um logotipo. Pode ser um logotipo gráfico ou um logotipo de título. Inclua a sobreposição correspondente para especificar qual.

Para ser válido, use apenas um desses tipos.

  • poster: uma imagem de pôster para o programa. Nas interfaces de computador, eles podem ser usados em carrosséis. Eles podem ou não conter o título da série.
  • background: uma imagem adequada para uso como plano de fundo com sobreposições de texto ou interface. Essas imagens não contêm texto.

Para ser válido, inclua no máximo um desses usos recomendados.

Adequação do tamanho

  • smallFormat: uma imagem adequada para telas menores, como smartphones. Qualquer texto ou logotipo na imagem é legível em uma tela pequena.

  • largeFormat: uma imagem adequada para telas maiores ou pôsteres impressos.

Uma imagem pode usar os dois valores.

Adequação do plano de fundo

  • forDarkBackground: uma imagem, normalmente um logotipo transparente, adequada para uso em um plano de fundo escuro.
  • forLightBackground: uma imagem, geralmente um logotipo transparente, adequada para uso em um plano de fundo claro.

Para ser válido, use no máximo um valor de adequação do plano de fundo.

Sobreposições

  • hasTitle: o título do programa ou o nome do personagem ou ator incluído na imagem. Inclua a propriedade inLanguage para a imagem.
  • noTitle: a imagem não inclui o título.
  • hasLogo: a imagem inclui o logotipo de um filme ou programa, do proprietário do conteúdo ou do distribuidor.
  • noLogo: a imagem não inclui um logotipo.
  • hasCopyright: a imagem inclui uma notificação de direitos autorais visível.
  • noCopyright: a imagem não inclui uma notificação de direitos autorais visível. Em geral, o Google não pode usar essas imagens sem modificação.
  • hasMatte: a imagem tem uma máscara. Isso pode ser horizontal (letterbox), vertical (pillarbox) ou ambos (windowbox). Às vezes, as imagens são foscas para se ajustar a uma proporção. Em geral, o Google não pode usar essas imagens sem modificação.
  • noMatte: a imagem não tem um fosco.
  • transparentBackground: o plano de fundo da imagem é transparente. Isso é normalmente usado para imagens que são apenas um título ou logotipo e nada mais.

Para ser válido, apenas um título, um logotipo, um direito autoral e um atributo de máscara são permitidos.

Posição da figura predominante

  • centered: a figura predominante é posicionada no centro da imagem.
  • rightCentered: a figura predominante é posicionada no lado direito da imagem, o que deixa o lado esquerdo relativamente vazio para texto e sobreposições de interface.
  • leftCentered: a figura predominante é posicionada no lado esquerdo da imagem, o que deixa o lado direito relativamente vazio para sobreposições de texto e interface.

Para ser válido, inclua no máximo uma dessas posições.

Exemplos de imagens com o uso pretendido

Uma interface de TV que mostra uma imagem de plano de fundo com texto e sobreposição de interface.
Uma interface de TV que mostra carrosséis com imagens de pôster em uma imagem de fundo.
Uma interface para dispositivos móveis com uma imagem de pôster e uma imagem de fundo iconic.
Uma interface para dispositivos móveis com uma imagem de pôster e uma imagem de fundo sceneStill.

Exemplos de imagens e os respectivos contentAttributes

contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]
contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]
contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]
contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}
contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]
contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]
contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]

Tipos de imagem desejados para produtos do Google

Diferentes produtos e plataformas do Google exigem diferentes tipos de imagem e proporções. Para garantir que o conteúdo seja exibido corretamente em todos os produtos do Google, solicitamos que os provedores forneçam todos os tipos de imagem da tabela a seguir.

Proporção e contentAttributes Resolução mínima (pixels) Filme Série de TV Temporada de TV Episódio de TV Serviço de transmissão
16:9, iconic poster 3840 x 2160
2:3, iconic poster 1000x1500
4:3, iconic poster 800x600
1:1, iconic poster 600x600

3:4, iconic poster

 600x800

16:9, iconic background [preferencial] ou sceneStill

 3840 x 2160

2:3, iconic background [preferencial] ou sceneStill

 1000x1500

3:4, iconic background [preferencial] ou sceneStill

 600x800
1:1, logotipo do programa (hasLogo) 600x600
4:3, logotipo do canal (logo) 800x600
1:1, logotipo do canal (logo) 600x600
16:9, logotipo do canal (logo) 3840 x 2160

9:5, hasTitle logo (com transparentBackground e forLightBackground e forDarkBackground)

 1.800 x 1.000

As diretrizes a seguir se aplicam ao envio de imagens:

  1. As imagens precisam estar nos formatos JPEG, PNG ou WebP.
  2. Inclua as imagens de maior resolução que você tiver.
  3. Os arquivos não podem exceder 20 MB.
  4. centered imagens são preferíveis. As imagens de plano de fundo rightCentered e leftCentered também podem ser usadas por alguns produtos. Portanto, inclua-as se tiver.
  5. Preferimos imagens que funcionem tanto para smallFormat quanto para largeFormat.
  6. É possível incluir tamanhos de imagem além dos listados na tabela anterior.
  7. Verifique se a proporção de cada imagem é um dos valores comuns listados na tabela anterior. Caso contrário, um aviso será emitido.

Exemplos de imagens com esquema

Os exemplos a seguir mostram como formatar o esquema para imagens associadas a filmes ou programas de TV.

Imagem de plano de fundo de um filme com dois personagens

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/my_favorite_movie",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A Movie poster",
    "Keywords": ["Mauren, Lord Wingflap the Destroyer"],
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" },
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"},
                           {"@type": "Country", "name": "CA"},
                           {"@type": "Country", "name": "AU"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

Imagem de plano de fundo de TVSeries restrita a duas regiões

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "TVSeries",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/mountain_view",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A TV Show",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "regionsAllowed": [{ "@type": "Country", "name": "US" },
                       { "@type": "Country", "name": "GB" }],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "background", "rightCentered", "smallFormat",
                  "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
      }
    ]
  }
}

Imagem de pôster de filme destinada a duas regiões

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": [{ "@type": "Country", "name": "US" },
                 { "@type": "Country", "name": "GB" }],
    "character": [
      {
        "@type": "Person",
        "name": "Captain Pulsar"
      }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle",
                  "hasLogo", "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

Pôster de filme em formato grande com texto em coreano e inglês

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["kr", "en"],
    "audience": { "@type": "Country", "name": "KR" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" },
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

Representação de várias imagens por região

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-us.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["en"],
    "audience": { "@type": "Country", "name": "US" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}

Representação de imagens com restrição de tempo

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-jp.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "datePublished": "2022-10-31T17:00:00Z",
    "expires": "2025-10-31T16:59:59Z",
    "inLanguage": ["ja"],
    "audience": { "@type": "Country", "name": "JP" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "datePublished": "2021-10-31T17:00:00Z",
      "expires": "2023-10-31T16:59:59Z",
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}