Propriedades de imagem

Esta seção detalha as propriedades de marcação de conteúdo de image para filmes e TV programas Essa marcação permite que os provedores descrevam o tipo de imagem, por exemplo, um título, plano de fundo ou imagem icônica e a sugestão de uso.

Tabela de especificações

A propriedade image pode ser fornecida para Movie, TVSeries, TVSeason, ou TVEpisode tipos de entidade. A tabela a seguir descreve as propriedades disponíveis para image. Observe que a propriedade additionalProperty inclui um nome da propriedade personalizada chamada 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 defina como "http://schema.org".
@type Texto Obrigatório: sempre defina 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, ler contentAttributes
character Person

Obrigatório: um personagem fictício associado a a imagem. Obrigatório se contentAttribute inclui castInCharacter.
inLanguage Texto Obrigatório se aplicável: o idioma do texto usado no imagem. Use um dos códigos de idioma Padrão IETF BCP 47. Se a imagem incluir um contentAttribute de hasTitle, esta propriedade é obrigatória.
regionsAllowed Place Recomendado: as regiões em que a imagem é permitida. Caso contrário especificado, presume-se que a imagem seja permitida em todos os lugares. Especifique os países em Formato ISO 3166.
datePublished Data

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

  • A data pode ser definida no futuro.

Se houver restrições de uso da imagem com base no tempo, esta propriedade será obrigatório se a imagem não deve ser exibida antes da data especificada. Se não houver ela pode ser omitida. É obrigatório que a imagem correspondente ser fornecidas no feed pelo menos sete dias antes da data de publicação. Isso vai aumentar as chances de o conteúdo aparecer nas plataformas do Google a tempo.

expires Data

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

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

É obrigatório que as atualizações da data de validade sejam feitas no feed pelo menos 7 dias antes da data de validade. Isso aumenta as chances de o conteúdo parar apareçam nas plataformas do Google na data de validade.

audience Público Recomendado: é o público-alvo pretendido ou preferido. imagem.
audience.geographicArea AdministrativeArea Recomendada: as regiões pretendidas ou preferenciais para a imagem. Por outro lado, use regionsAllowed para especificar restrições. Se audience.geographicArea não for especificado, ele será usado em qualquer lugar. Especifique o países em Formato ISO 3166.
copyrightHolder Organização 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. 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 de contentAttributes que os provedores precisam incluir em cada ImageObject.

Tipo

  • iconic: uma imagem ilustrativa que exemplifica o programa. Muitas vezes, uma arte renderização.
  • sceneStill: um trecho de imagem do programa.
  • castInCharacter: uma foto de um membro do elenco como ele aparece no personagem. Se usar esse valor, inclua também o character para identificar o caractere específico na imagem. Se houver vários personagens, como em um conjunto de 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 com título. Inclua a overlay correspondente para especificar qual.

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

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

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

Adequação do tamanho

  • smallFormat: uma imagem adequada para telas menores, como de dispositivos móveis celulares. Textos 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 em segundo plano

  • forDarkBackground: uma imagem, normalmente um logotipo transparente, que é adequada para uso em um fundo escuro.
  • forLightBackground: uma imagem, normalmente um logotipo transparente, que é 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. Inclua a propriedade inLanguage para o 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. Google geralmente não podem usar essas imagens sem fazer modificações.
  • hasMatte: a imagem tem um tom fosco. Pode ser horizontal (com efeito letterbox), vertical (pillarbox) ou ambas (windowbox). Às vezes, as imagens são emaranhadas para caber em uma proporção. Em geral, o Google não pode usar essas imagens sem modificação.
  • noMatte: a imagem não tem um tom 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, somente um título, um logotipo, um direitos autorais e um atributo fosco são permitidos.

Posição da figura predominante

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

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ôsteres em um plano de fundo imagem.
.
Uma interface para dispositivos móveis com uma imagem de pôster e um plano de fundo Imagem iconic.
.
Uma interface para dispositivos móveis com uma imagem de pôster e um plano de fundo Imagem sceneStill.

Exemplos de imagens e 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 imagens desejadas para produtos do Google

Produtos e plataformas do Google diferentes exigem requisitos tipos de imagem e proporções. Para garantir que o conteúdo seja exibido corretamente em todos os produtos do Google, solicitamos que os fornecedores forneçam todos dos 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 1.000 x 1.500
16:3, iconic poster 800x600
individual, 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

 1.000 x 1.500

3:4, iconic background [preferencial] 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 ambos 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 as imagens de maior resolução que você tiver.
  3. Os arquivos não podem exceder 20 MB.
  4. Dê preferência a centered imagens. rightCentered e leftCentered as imagens de plano de fundo também podem ser usadas por alguns produtos, então você pode incluí-las caso os tenha.
  5. Preferimos imagens que funcionem para smallFormat e largeFormat.
  6. Você pode incluir tamanhos de imagem além dos listados nos itens anteriores tabela.
  7. Verifique se a proporção de cada imagem é um dos valores comuns listados em da tabela anterior. Caso contrário, um aviso é enviado.

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 da 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 de filme grande 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"]
        }
      ]
    }]
}

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