Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Propiedades de imágenes

En esta sección, se detallan las propiedades de lenguaje de marcado de contenido de image para películas, programas de TV, transmisiones de TV en vivo y eventos deportivos. Este lenguaje de marcado permite que los proveedores describan el tipo de imagen, por ejemplo, si es un título, un fondo o una imagen icónica, y su uso sugerido.

Tabla de especificaciones

La propiedad image se puede proporcionar para los tipos de entidad Movie, TVSeries, TVSeason, TVEpisode, SportsEvent o BroadcastEvent. En la siguiente tabla, se describen las propiedades disponibles para la propiedad image. Observa que la propiedad additionalProperty incluye un nombre de propiedad personalizada llamado contentAttributes, que contiene un array de valores que describen 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 información, consulta `contentAttributes`.
`character`	Persona	Obligatorio si corresponde: Es un personaje ficticio asociado con la imagen. Este campo es obligatorio si `contentAttribute` incluye `castInCharacter`. Nota: Puedes usar el tipo `Person` aquí, incluso si el personaje no es humano.
`inLanguage`	Texto	Obligatorio si corresponde: Es el idioma del texto que se usa en la 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: Indica las regiones en las que se permite reproducir la imagen. Si no se especifica, se supone que la imagen está permitida en todas partes. Especifica los países en formato ISO 3166.
`datePublished`	Fecha	Obligatorio si corresponde: Es la fecha a partir de la cual la imagen está disponible, en formato ISO 8601 (incluida la zona horaria). La fecha se puede establecer en el futuro. Si hay restricciones basadas en el tiempo para el uso de la imagen, esta propiedad es obligatoria si la imagen no se debe mostrar antes de la fecha indicada. Si no existe tal restricción, se puede omitir. Se requiere que la imagen correspondiente se proporcione en el feed al menos 7 días antes de su datePublished. Esto aumentará las probabilidades de que el contenido aparezca en las plataformas de Google a tiempo.
`expires`	Fecha	Obligatorio si corresponde: Es la fecha después de la cual la imagen ya no estará disponible, en formato ISO 8601 (incluida la zona horaria). Si el contenido siempre está disponible después de publicarse, puedes omitir esta propiedad. Es obligatorio que las actualizaciones de la fecha de vencimiento se realicen en el feed al menos 7 días antes de la fecha de vencimiento. Esto aumentará las probabilidades de que el contenido deje de aparecer en las plataformas de Google en la fecha de vencimiento.
`audience`	Público	Recomendado: Es el público objetivo o preferido para esta imagen.
`audience.geographicArea`	AdministrativeArea	Recomendado: Son las regiones previstas o preferidas para esta imagen. En cambio, usa `regionsAllowed` para especificar restricciones estrictas. Si no se especifica `audience.geographicArea`, se supone que se puede usar en cualquier lugar. Especifica los países en formato ISO 3166.
`copyrightHolder`	Organization o Person	Recomendado: Es la parte que posee los derechos de autor de la imagen.
`keywords`	Texto	Recomendado: Palabras clave o etiquetas que se usan para describir esta imagen. Se pueden proporcionar varios `keywords` con un array. Por ejemplo, ["feature, biography"]
`name`	Texto	Recomendado: Es el nombre de la imagen.
`width`	Número entero	Opcional: Es el ancho de la imagen en píxeles, expresado como un número entero positivo (por ejemplo, `1920`). No incluyas cadenas de unidades, como `"px"`.
`height`	Número entero	Opcional: Es la altura de la imagen en píxeles, expresada como un número entero positivo (por ejemplo, `1080`). No incluyas cadenas de unidades, como `"px"`.

contentAttributes

La propiedad contentAttributes de image describe el tipo de imagen y define sus usos sugeridos. Las categorías de la siguiente lista incluyen los valores de contentAttributes que los proveedores deben incluir con cada ImageObject.

Tipo

iconic: Es una imagen ilustrativa que ejemplifica el programa. A menudo, es una representación artística.
sceneStill: Es un extracto de imagen del programa.
castInCharacter: Es una foto de un miembro del elenco caracterizado como su personaje. Si usas este valor, incluye también la propiedad character para identificar el personaje específico en la imagen. Si hay varios personajes, como en un elenco, incluye varias propiedades character como un array.
logo: La imagen solo contiene un logotipo. Puede ser un logotipo gráfico o un logotipo de título. Incluye la superposición correspondiente para especificar cuál.

Para que sea válido, usa solo uno de estos tipos.

Uso recomendado

poster: Es una imagen de póster del programa. En las IU de computadoras, se pueden usar en carruseles. Estos pueden o no contener el título del programa.
background: Es una imagen adecuada para usar como fondo con texto o superposiciones de IU. Estas imágenes no contienen texto.

Para que sea válido, 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 las de los teléfonos celulares. Cualquier texto o logotipo en la imagen es legible en una pantalla pequeña.
largeFormat: Es una imagen adecuada para pantallas más grandes o pósteres impresos.

Nota: Por lo general, la mayoría de las imágenes son adecuadas para formatos grandes. Las excepciones son las imágenes con baja resolución, que se verían pixeladas si se escalaran a un tamaño mayor.

Una imagen puede usar ambos valores.

Idoneidad del fondo

forDarkBackground: Es una imagen, por lo general, un logotipo transparente, que es adecuada para usar en un fondo oscuro.
forLightBackground: Es una imagen, por lo general, un logotipo transparente, que es adecuada para usar en un fondo claro.

Para que sea válido, usa como máximo un valor de idoneidad de fondo.

Superposiciones

hasTitle: Es el título del programa o el nombre del personaje o actor que se incluye con la imagen. Asegúrate de incluir la propiedad inLanguage para la 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 sobre derechos de autor visible. Por lo general, Google no puede usar esas imágenes sin modificarlas.
hasMatte: La imagen tiene un mate. Esto puede ser horizontal (formato letterbox), vertical (formato pillarbox) o ambos (formato windowbox). A veces, las imágenes se enmarcan para que se ajusten a una relación de aspecto. Por lo general, Google no puede usar esas imágenes sin modificarlas.
noMatte: La imagen no tiene un mate.
transparentBackground: El fondo de la imagen es transparente. Por lo general, se usa para imágenes que solo son un título o un logotipo, y nada más.

Para que sea válido, solo se permite un atributo de título, un atributo de logotipo, un atributo de derechos de autor y un atributo de mate.

Posición de la figura predominante

centered: La figura predominante se coloca en el centro de la imagen.
rightCentered: La figura predominante se ubica hacia el lado derecho de la imagen, lo que deja el lado izquierdo relativamente vacío para el texto y las superposiciones de la IU.
leftCentered: La figura predominante se ubica hacia el lado izquierdo de la imagen, lo que deja el lado derecho relativamente vacío para las superposiciones de texto y de la IU.

Para que sea válido, incluye, como máximo, una de estas posiciones.

Imágenes de ejemplo con su uso previsto

Una IU de TV que muestra una imagen de fondo con texto y una superposición de IU.

Una IU de TV que muestra carruseles con imágenes de pósteres sobre una imagen de fondo.

Una IU para dispositivos móviles con una imagen de póster y una imagen de `iconic` fondo.

Una IU para dispositivos móviles con una imagen de póster y una imagen de `sceneStill` fondo.

Imágenes de ejemplo y sus 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 imágenes deseados para los productos de Google

Los diferentes productos y plataformas de Google requieren distintos 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 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, `iconic` `poster`	3840 × 2160
2:3, `iconic` `poster`	1000 x 1500
4:3, `iconic` `poster`	800x600
1:1, `iconic` y `poster`	600 x 600
3:4, `iconic` y `poster`	600 × 800
16:9, `iconic` `background` [preferido] o `sceneStill`	3840 × 2160
2:3, `iconic` `background` [preferido] o `sceneStill`	1000 x 1500
3:4, `iconic` `background` [preferida] o `sceneStill`	600 × 800
1:1, Mostrar logotipo (`hasLogo`)	600 x 600
4:3, logotipo del canal (`logo`)	800x600
1:1, logotipo del canal (`logo`)	600 x 600
16:9, logotipo del canal (`logo`)	3840 × 2160
9:5, `hasTitle` `logo` (con `transparentBackground` y `forLightBackground` y `forDarkBackground`)	1,800 x 1,000

Sigue estos lineamientos cuando envíes imágenes:

Las imágenes deben estar en formato JPEG, PNG o WebP.
Incluye las imágenes con la resolución más alta que tengas.
El tamaño de los archivos no debe superar los 20 MB.
Se recomiendan centered imágenes. Algunos productos también pueden usar imágenes de fondo rightCentered y leftCentered, por lo que puedes incluirlas si las tienes.
Preferimos imágenes que funcionen tanto para smallFormat como para largeFormat.
Puedes incluir tamaños de imagen además de los que se indican en la tabla anterior.
Verifica que la relación de aspecto de cada imagen sea uno de los valores comunes que se indican en la tabla anterior. De lo contrario, se emite una advertencia.

Imágenes de ejemplo con esquema

En los siguientes ejemplos, se muestra cómo dar formato al esquema de las imágenes asociadas con películas o programas de TV.

Imagen de fondo de una película con dos personajes

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

La imagen de fondo de TVSeries está restringida a dos regiones

{
  "@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 destinada a dos regiones

{
  "@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 película de gran formato con texto en coreano y en 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"]
      }
    ]
  }
}

Representación de 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"]
        }
      ]
    }]
}

Representación de 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"]
        }
      ]
    }]
}