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 |
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).
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).
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 propriedadecharacter
para identificar o caractere específico na imagem. Se houver vários caracteres, como em um conjunto de transmissão, inclua várias propriedadescharacter
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.
Uso recomendado
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 propriedadeinLanguage
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
Exemplos de imagens e os respectivos contentAttributes
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, |
600x800 | |||||
16:9, |
3840 x 2160 | |||||
2:3, |
1.000 x 1.500 | |||||
3:4, |
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, |
1.800 x 1.000 |
As seguintes diretrizes se aplicam quando você envia imagens:
- As imagens precisam estar nos formatos JPEG, PNG ou WebP.
- Inclua imagens em alta resolução.
- Os tamanhos dos arquivos não podem exceder 20 MB.
centered
imagens são preferenciais. As imagens de plano de fundorightCentered
eleftCentered
também podem ser usadas por alguns produtos, portanto, é possível incluí-las se você as tiver.- Preferimos imagens que funcionam para
smallFormat
elargeFormat
. - É possível incluir tamanhos de imagem além dos listados na tabela anterior.
- 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"]
}
]
}]
}