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 |
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).
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).
É 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 ocharacter
para identificar o caractere específico na imagem. Se houver vários personagens, como em um conjunto de elenco, inclua várias propriedadescharacter
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.
Uso recomendado
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 propriedadeinLanguage
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
![](https://developers.google.cn/static/actions/media/images/image-properties-1.png?authuser=8&hl=pt-br)
![](https://developers.google.cn/static/actions/media/images/image-properties-2.png?authuser=8&hl=pt-br)
![](https://developers.google.cn/static/actions/media/images/image-properties-3.png?authuser=8&hl=pt-br)
iconic
.![](https://developers.google.cn/static/actions/media/images/image-properties-4.png?authuser=8&hl=pt-br)
sceneStill
.Exemplos de imagens e contentAttributes
![](https://developers.google.cn/static/actions/media/images/image-properties-5.png?authuser=8&hl=pt-br)
contentAttributes: ["iconic", "poster", "centered",
"hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-6.png?authuser=8&hl=pt-br)
contentAttributes: ["iconic", "background", "centered",
"smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright",
"noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-7.png?authuser=8&hl=pt-br)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-8.png?authuser=8&hl=pt-br)
contentAttributes: ["iconic", "background",
"rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-9.png?authuser=8&hl=pt-br)
contentAttributes: ["iconic", "poster", "smallFormat",
"largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers.google.cn/static/actions/media/images/image-properties-10.png?authuser=8&hl=pt-br)
contentAttributes: ["iconic", "poster", "largeFormat",
"hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers.google.cn/static/actions/media/images/image-properties-11.png?authuser=8&hl=pt-br)
contentAttributes: ["castInCharacter", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character:
{name: "Captain Pulsar"}
![](https://developers.google.cn/static/actions/media/images/image-properties-12.png?authuser=8&hl=pt-br)
contentAttributes: ["logo", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-13.png?authuser=8&hl=pt-br)
contentAttributes: ["logo", "hasTitle", "hasLogo"
"noCopyright", "noMatte", "centered", "transparentBackground",
"forLightBackground", "forDarkBackground", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-14.png?authuser=8&hl=pt-br)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"hasCopyright", "noMatte"]
![](https://developers.google.cn/static/actions/media/images/image-properties-15.png?authuser=8&hl=pt-br)
contentAttributes: ["iconic", "poster", "centered",
"noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat",
"largeFormat"]
![](https://developers.google.cn/static/actions/media/images/image-properties-16.png?authuser=8&hl=pt-br)
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, |
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 as imagens de maior resolução que você tiver.
- Os arquivos não podem exceder 20 MB.
- Dê preferência a
centered
imagens.rightCentered
eleftCentered
as imagens de plano de fundo também podem ser usadas por alguns produtos, então você pode incluí-las caso os tenha. - Preferimos imagens que funcionem para
smallFormat
elargeFormat
. - Você pode incluir tamanhos de imagem além dos listados nos itens anteriores tabela.
- 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
![](https://developers.google.cn/static/actions/media/images/image-properties-8.png?authuser=8&hl=pt-br)
{
"@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
![](https://developers.google.cn/static/actions/media/images/image-properties-8.png?authuser=8&hl=pt-br)
{
"@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
![](https://developers.google.cn/static/actions/media/images/image-properties-9.png?authuser=8&hl=pt-br)
{
"@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
![](https://developers.google.cn/static/actions/media/images/image-properties-17.png?authuser=8&hl=pt-br)
{
"@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"]
}
]
}]
}