En esta sección, se detallan las propiedades de lenguaje de marcado de contenido de image
para películas y TV
programas. Este lenguaje de marcado permite que los proveedores describan el tipo de imagen, por ejemplo,
es un título, un fondo o una imagen icónica, y su uso sugerido.
Tabla de especificación
La propiedad image
puede proporcionarse para
Movie
,
TVSeries
:
TVSeason
,
o TVEpisode
tipos de entidades. En la siguiente tabla, se describen las propiedades disponibles para el
image
. Ten en cuenta que la propiedad additionalProperty
incluye una
nombre de la propiedad personalizada llamada contentAttributes
, que
contiene un array de valores que describe el tipo de imagen y su uso previsto.
Propiedad | Tipo esperado | Descripción |
---|---|---|
@context |
Texto | Obligatorio: Siempre se establece en "http://schema.org" . |
@type |
Texto | Obligatorio: Siempre se establece en ImageObject . |
contentUrl |
URL | Obligatorio: Es la URL de la imagen. |
additionalProperty |
PropertyValue | Obligatorio: Define la propiedad contentAttributes .
que describe el tipo de imagen y su uso previsto. Para obtener más detalles,
leer
contentAttributes |
character |
Persona |
Obligatorio si corresponde: un personaje ficticio asociado con
la imagen. Esto es obligatorio si |
inLanguage |
Texto | Obligatorio si corresponde: El idioma del texto que se usa en las
imagen. Usa uno de los códigos de idioma del
Estándar IETF BCP 47.
Si la imagen incluye un contentAttribute de
hasTitle , esta propiedad es obligatoria. |
regionsAllowed |
Place | Recomendado: Las regiones donde se permite la imagen. Si no es así especificada, se supone que la imagen está permitida en todas partes. Especifica los países en Formato ISO 3166: |
datePublished |
Fecha | Obligatorio si corresponde: Fecha en la que la imagen estará disponible, en ISO Formato 8601 (incluida la zona horaria)
Si hay restricciones basadas en el tiempo para el uso de la imagen, esta propiedad se obligatorio si la imagen no debe mostrarse antes de la fecha indicada. Si no existe existe una restricción, se puede omitir. Es necesario que la imagen correspondiente proporcionarse en el feed al menos 7 días antes de su fecha de publicación. Si confirmas esta acción, aumentan las posibilidades de que el contenido se muestre a tiempo en las plataformas de Google. |
expires |
Fecha | Obligatorio si corresponde: Fecha en la que la imagen dejará de estar disponible. en ISO Formato 8601 (incluida la zona horaria)
Las actualizaciones que se realicen en la fecha de vencimiento deben realizarse en el feed, como mínimo, 7 días antes de la fecha de vencimiento. Esto aumentará las posibilidades de que el contenido cese para que aparezca en las plataformas de Google en la fecha de vencimiento. |
audience |
Público | Recomendado: Indica el público objetivo o preferido de esta opción. imagen. |
audience.geographicArea |
AdministrativeArea | Recomendado: Las regiones deseadas o preferidas para esta imagen.
Por el contrario, usa regionsAllowed para especificar
de manera predeterminada. Si no se especifica audience.geographicArea ,
entonces se supone que está diseñado para usarse en todas partes. Especifica el
países de
Formato ISO 3166: |
copyrightHolder |
Organización o Person | Recomendado: La parte propietaria de los derechos de autor de la imagen. |
keywords |
Texto | Recomendadas: Las palabras clave o etiquetas utilizadas para describir esta imagen.
Se pueden proporcionar varios keywords usando un array. Por ejemplo, ["feature, biography"] |
name |
Texto | Recomendado: Nombre de la imagen. |
contentAttributes
La propiedad contentAttributes
de image
describe el tipo de imagen y
define sus usos sugeridos. Las categorías de la siguiente lista incluyen
Valores de contentAttributes
que los proveedores deben incluir con cada ImageObject
.
Tipo
iconic
: Es una imagen ilustrativa que ejemplifica el programa. Suele ser artístico y procesamiento.sceneStill
: Un extracto de imagen del programa.castInCharacter
: Es la foto de un miembro del reparto tal como aparece en su personaje. Si si usas este valor, incluye tambiéncharacter
para identificar el carácter específico en el imagen. Si hay varios personajes, como en un ensamble del elenco, incluye lo siguiente: varias propiedadescharacter
como un array.logo
: La imagen contiene solo un logotipo. Puede ser un logotipo gráfico o un título de logotipo. Incluye la superposición correspondiente para especificar cuál de estas opciones.
Para ser válido, usa solo uno de estos tipos.
Uso recomendado
poster
: Es una imagen de póster del programa. En las IU para computadoras, estos pueden usarse en como carruseles. Pueden o no incluir el título del programa.background
: Es una imagen adecuada para usar como fondo con texto o IU. superposiciones. Estas imágenes no contienen texto.
Para que la solicitud sea válida, incluye como máximo uno de estos usos recomendados.
Idoneidad del tamaño
smallFormat
: Es una imagen adecuada para pantallas más pequeñas, como los dispositivos móviles. teléfonos. El texto o los logotipos de la imagen deben ser legibles en una pantalla pequeña.largeFormat
: Es una imagen adecuada para pantallas más grandes o pósteres impresos.
Una imagen puede usar ambos valores.
Idoneidad en segundo plano
forDarkBackground
: Una imagen (por lo general, un logotipo transparente) que es adecuada para usarla en un fondo oscuro.forLightBackground
: Una imagen (por lo general, un logotipo transparente) que es adecuada para usarla sobre un fondo claro.
Para que la solicitud sea válida, usa como máximo un valor de idoneidad para segundo plano.
Superposiciones
hasTitle
: Es el título del programa o el nombre del personaje o el actor. que se incluye con la imagen. Asegúrate de incluir la propiedadinLanguage
para el imagen.noTitle
: La imagen no incluye el título.hasLogo
: La imagen incluye el logotipo de una película o un programa, el propietario del contenido o el distribuidor.noLogo
: La imagen no incluye un logotipo.hasCopyright
: La imagen incluye un aviso sobre derechos de autor visible.noCopyright
: La imagen no incluye un aviso de derechos de autor visible. Google por lo general, no pueden usar esas imágenes sin modificaciones.hasMatte
: La imagen tiene un efecto mate. Puede ser horizontal (letterbox), vertical (pillarbox) o ambos (windowbox). A veces, las imágenes se cubren para ajustarse en una relación de aspecto. Por lo general, Google no puede usar este tipo de imágenes sin en caso de que haya modificaciones.noMatte
: La imagen no tiene un efecto mate.transparentBackground
: El fondo de la imagen es transparente. Este es normalmente se usa para imágenes que son solo un título o logotipo, y nada más.
Para que sea válido, agrega un solo título, un logotipo, un derecho de autor y un atributo mate .
Posición de la figura predominante
centered
: La figura predominante se posiciona en el centro de la imagen.rightCentered
: La figura predominante se posiciona hacia el lado derecho. de la imagen, lo que deja el lado izquierdo relativamente vacío para el texto y la IU superposiciones.leftCentered
: La figura predominante se posiciona hacia el lado izquierdo de la imagen, lo que deja el lado derecho relativamente vacío para el texto y la IU superposiciones.
Para que la información sea válida, incluye como máximo una de estas posiciones.
Imágenes de ejemplo con su uso previsto
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-1.png?authuser=19&hl=es)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-2.png?authuser=19&hl=es)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-3.png?authuser=19&hl=es)
iconic
.![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-4.png?authuser=19&hl=es)
sceneStill
.Imágenes de ejemplo y sus contentAttributes
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-5.png?authuser=19&hl=es)
contentAttributes: ["iconic", "poster", "centered",
"hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-6.png?authuser=19&hl=es)
contentAttributes: ["iconic", "background", "centered",
"smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright",
"noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-7.png?authuser=19&hl=es)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=19&hl=es)
contentAttributes: ["iconic", "background",
"rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=19&hl=es)
contentAttributes: ["iconic", "poster", "smallFormat",
"largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-10.png?authuser=19&hl=es)
contentAttributes: ["iconic", "poster", "largeFormat",
"hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-11.png?authuser=19&hl=es)
contentAttributes: ["castInCharacter", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character:
{name: "Captain Pulsar"}
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-12.png?authuser=19&hl=es)
contentAttributes: ["logo", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-13.png?authuser=19&hl=es)
contentAttributes: ["logo", "hasTitle", "hasLogo"
"noCopyright", "noMatte", "centered", "transparentBackground",
"forLightBackground", "forDarkBackground", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-14.png?authuser=19&hl=es)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"hasCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-15.png?authuser=19&hl=es)
contentAttributes: ["iconic", "poster", "centered",
"noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-16.png?authuser=19&hl=es)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"hasCopyright", "hasMatte"]
Tipos de imágenes deseados para los productos de Google
Los distintos productos y plataformas de Google requieren diferentes tipos de imágenes y relaciones de aspecto. Para garantizar que el contenido se muestre correctamente en todos los productos de Google, solicitamos que los proveedores proporcionen todos de los tipos de imágenes de la siguiente tabla.
Relación de aspecto y contentAttributes | Resolución mínima (píxeles) | Película | Series de TV | Temporada de TV | Episodio de TV | Servicio de transmisión |
---|---|---|---|---|---|---|
16:9, poster (iconic ) |
3840 × 2160 | |||||
2:3, poster (iconic ) |
1,000 x 1,500 | |||||
4:3 (iconic , poster ) |
800x600 | |||||
1:1, poster de iconic |
600x600 | |||||
3:4, |
600 × 800 | |||||
16:9, |
3840 × 2160 | |||||
2:3, |
1,000 x 1,500 | |||||
3:4, |
600 × 800 | |||||
1:1, Mostrar logotipo (hasLogo ) |
600x600 | |||||
4:3, logotipo del canal (logo ) |
800x600 | |||||
1:1, logotipo del canal (logo ) |
600x600 | |||||
16:9, logotipo del canal (logo ) |
3840 × 2160 | |||||
9:5, |
1,800 x 1,000 |
Los siguientes lineamientos se aplican cuando envías imágenes:
- Las imágenes deben estar en formato JPEG, PNG o WebP.
- Incluye las imágenes de mayor resolución que tengas.
- El tamaño de los archivos no debe superar los 20 MB.
- Se prefieren las imágenes
centered
.rightCentered
yleftCentered
imágenes de fondo también se pueden usar en algunos productos, para que puedas incluirlas si los tienes. - Preferimos imágenes que funcionen tanto para
smallFormat
como paralargeFormat
. - Puedes incluir tamaños de imagen además de los que se enumeran en la lista anterior desde una tabla de particiones.
- Verifica que la relación de aspecto de cada imagen sea uno de los valores comunes que se mencionan en en la tabla anterior. De lo contrario, se enviará una advertencia.
Imágenes de ejemplo con esquema
En los siguientes ejemplos, se muestra cómo dar formato al esquema para imágenes asociadas con películas o programas de TV.
Imagen de fondo de una película con dos caracteres
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=19&hl=es)
{
"@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"]
}
]
}
}
Imagen de fondo de TVSeries restringida a dos regiones
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=19&hl=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"]
}
]
}
}
Imagen de póster de película pensada para dos regiones
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=19&hl=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 la película en formato grande con texto en inglés y coreano
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-17.png?authuser=19&hl=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 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 varias imágenes por región
{
"@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 imágenes con restricción de tiempo
{
"@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"]
}
]
}]
}