Propriedades da imagem

Esta seção detalha as propriedades de marcação de conteúdo do image para filmes e programas de TV. Essa marcação permite que os provedores descrevam o tipo de imagem, por exemplo, se é um título, um plano de fundo ou uma 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 ou TVEpisode. A tabela a seguir descreve as propriedades disponíveis para a propriedade image. Observe que a propriedade additionalProperty inclui um nome de propriedade personalizado 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: defina sempre como "http://schema.org".
@type Texto Obrigatório: defina sempre 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 caractere fictício associado à imagem. Isso é necessá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 onde a imagem é permitida. Se não for especificado, presume-se que a imagem é permitida em todos os lugares. Especifique os países no formato ISO 3166.
datePublished Data

Obrigatório, se aplicável: é a data após a qual a imagem estará disponível, no formato ISO 8601 (incluindo fuso horário).

  • A data pode ser definida no futuro.

Se houver restrições com base no tempo de uso da imagem, essa propriedade será obrigatória caso a imagem não possa ser exibida antes da data especificada. Se essa restrição não existir, ela poderá ser omitida. É necessário fornecer a imagem correspondente no feed pelo menos sete dias antes da data de publicação. Isso aumenta as chances de o conteúdo ser exibido nas plataformas do Google dentro do prazo.

expires Data

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

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

Todas as atualizações na data de expiração precisam ser feitas no feed pelo menos sete dias antes da data de expiração. Isso aumenta 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 preferido para esta imagem.
audience.geographicArea Área administrativa Recomendado: são as regiões desejadas ou preferidas para esta imagem. Por outro lado, use regionsAllowed para especificar restrições rígidas. Se audience.geographicArea não for especificado, considera-se que ele se destina ao uso em todos os lugares. 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 essa imagem. Vários keywords podem ser fornecidos usando uma matriz. Por exemplo, ["recurso, biografia"]
name Texto Recomendado: nome da imagem.

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 do programa. Muitas vezes, uma renderização artística.
  • sceneStill: um trecho de imagem do programa.
  • castInCharacter: foto de um membro do elenco quando ele aparece no personagem. Se você usar esse valor, inclua também a propriedade character para identificar o caractere específico na imagem. Se houver vários caracteres, como em um conjunto de transmissão, 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. Inclua a overlay correspondente para especificar qual.

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

  • poster: uma imagem de pôster do programa. Em IUs de computador, elas podem ser usadas em carrosséis. Elas podem ou não conter o título do programa.
  • background: uma imagem adequada para uso como segundo plano com texto ou sobreposições de IU. Essas imagens não contêm texto.

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

Adequação do tamanho

  • smallFormat: uma imagem adequada para telas menores, como smartphones. Qualquer texto ou logotipos na imagem podem ser lidos em uma tela pequena.

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

Uma imagem pode usar esses dois valores.

Adequação ao segundo plano

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

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

Sobreposições

  • hasTitle: o título do programa ou o nome do personagem ou ator incluído na imagem. Certifique-se de incluir a propriedade inLanguage da imagem.
  • noTitle: a imagem não inclui o título.
  • hasLogo: a imagem inclui o logotipo de um filme ou programa, o proprietário do conteúdo ou o distribuidor.
  • noLogo: a imagem não inclui um logotipo.
  • hasCopyright: a imagem inclui um aviso de direitos autorais visível.
  • noCopyright: a imagem não inclui um aviso de direitos autorais visível. Em geral, o Google não pode usar essas imagens sem modificações.
  • hasMatte: a imagem tem um papel fosco. Pode ser horizontal (letterbox), vertical (pillarbox) ou ambos (windowbox). Às vezes, as imagens são foscas para se ajustar a uma proporção. O Google geralmente não pode usar essas imagens sem modificação.
  • noMatte: a imagem não tem papel fosco.
  • transparentBackground: o plano de fundo da imagem é transparente. Isso é usado normalmente 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 fosco 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 sobreposições de texto e IU.
  • leftCentered: a figura predominante é posicionada em direção ao lado esquerdo da imagem, o que deixa o lado direito relativamente vazio para sobreposições de texto e IU.

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

Exemplos de imagens com o uso pretendido

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

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

Produtos e plataformas do Google diferentes exigem tipos de imagem e proporções diferentes. 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
16h90, iconic poster 3840 x 2160
2:3, iconic poster 1.000 x 1.500
4:3, iconic poster 800x600
1:1, iconic poster 600x600

3:4, iconic poster

 600x800

16:9, iconic background [preferido] ou sceneStill

 3840 x 2160

2:3, iconic background [preferido] ou sceneStill

 1.000 x 1.500

3:4, iconic background [preferido] ou sceneStill

 600x800
1:1, Mostrar logotipo (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 seguintes diretrizes se aplicam quando você envia imagens:

  1. As imagens precisam estar nos formatos JPEG, PNG ou WebP.
  2. Inclua imagens em alta resolução.
  3. Os tamanhos dos arquivos não podem exceder 20 MB.
  4. centered imagens são preferenciais. As imagens de plano de fundo rightCentered e leftCentered também podem ser usadas por alguns produtos, portanto, é possível incluí-las se você as tiver.
  5. Preferimos imagens que funcionam para smallFormat e 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, será exibido um aviso.

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 do filme com dois caracteres

{
  "@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 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 do pôster do 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 grande de filmes com 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"]
      }
    ]
  }
}

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

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