Se usó la API de Cloud Translation para traducir esta página.

Propiedades de la imagen

En esta sección, se detallan las propiedades de lenguaje de marcado de contenido de image para películas y programas de TV. Este lenguaje de marcado permite que los proveedores describan el tipo de imagen, como un título, una imagen de 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 o TVEpisode. En la siguiente tabla, se describen las propiedades disponibles para la propiedad image. Ten en cuenta que la propiedad additionalProperty incluye un nombre de propiedad personalizado llamado contentAttributes, que contiene un array de valores que describen el tipo de imagen y su uso previsto.

Propiedad	Tipo esperado	Descripción
`@context`	Text	Obligatorio: Siempre se establece en `"http://schema.org"`.
`@type`	Text	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, lee `contentAttributes`.
`character`	Persona	Obligatorio si corresponde: Es un carácter ficticio asociado con la imagen. Es obligatorio si `contentAttribute` incluye `castInCharacter`. Nota: Puedes usar el tipo `Person` aquí, incluso si el carácter no es humano.
`inLanguage`	Text	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: Las regiones en las que se permite 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 después de la cual la imagen estará 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 debe mostrarse antes de la fecha determinada. Si no existe tal restricción, se puede omitir. Es necesario que la imagen correspondiente se proporcione en el feed al menos 7 días antes de su fecha de publicación. De esta manera, es más probable que el contenido se muestre a tiempo en las plataformas de Google.
`expires`	Fecha	Obligatorio si corresponde: Es una 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 su publicación, puedes omitir esta propiedad. Es necesario 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 posibilidades de que el contenido deje de aparecer en las plataformas de Google en la fecha de vencimiento.
`audience`	Público	Recommended: El público deseado o preferido para esta imagen.
`audience.geographicArea`	Área administrativa	Recommended: Las regiones correspondientes o preferidas para esta imagen. Por el contrario, usa `regionsAllowed` para especificar restricciones estrictas. Si no se especifica `audience.geographicArea`, se supone que está destinado a usarse en cualquier lugar. Especifica los países en formato ISO 3166.
`copyrightHolder`	Organización o Persona	Se recomienda: La parte que posee los derechos de autor de la imagen.
`keywords`	Text	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`	Text	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 los valores de contentAttributes que los proveedores deben incluir con cada ImageObject.

Tipo

iconic: Es una imagen ilustrativa que ejemplifica el programa. Es una representación artística.
sceneStill: Es un extracto de imagen del programa.
castInCharacter: Es una foto de un miembro del reparto tal como aparece en un personaje. Si usas este valor, también debes incluir la propiedad character para identificar el carácter específico en la imagen. Si hay varios caracteres, como en un conjunto de transmisión, incluye varias propiedades de character como un array.
logo: La imagen solo contiene un logotipo. Puede ser un logotipo gráfico o un título. Incluye la superposición correspondiente para especificar cuál.

Para ser válidos, usa solo uno de estos tipos.

Uso recomendado

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

Para ser válidos, incluye como máximo uno de estos usos recomendados.

Idoneidad para el tamaño

smallFormat: Es una imagen adecuada para pantallas más pequeñas, como teléfonos celulares. Cualquier texto o logotipo de la imagen se puede leer en una pantalla pequeña.
largeFormat: Es una imagen adecuada para pantallas más grandes o pósteres impresos.

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

Una imagen puede utilizar ambos valores.

Idoneidad para el fondo

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

Para ser válido, usa como máximo un valor de idoneidad en segundo plano.

Superposiciones

hasTitle: Es el título del programa o el nombre del personaje o actor incluido en 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 de un programa, el propietario del contenido o el distribuidor.
noLogo: La imagen no incluye un logotipo.
hasCopyright: La imagen incluye un aviso de derechos de autor visible.
noCopyright: La imagen no incluye un aviso de derechos de autor visible. Por lo general, Google no puede usar estas imágenes sin modificaciones.
hasMatte: La imagen tiene una imagen mate. Puede ser horizontal (formato letterbox), vertical (pillarbox) o ambos (windowbox). A veces, las imágenes se recogen para adaptarse a una relación de aspecto. Por lo general, Google no puede usar tales imágenes sin modificación.
noMatte: La imagen no tiene una imagen mate.
transparentBackground: El fondo de la imagen es transparente. Por lo general, se usa para imágenes que son solo un título o un logotipo.

Para ser válidos, solo se permiten un título, un logotipo, un derecho de autor y un atributo mate.

Posición de la figura predominante

centered: La figura predominante se coloca 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 las superposiciones de texto y de IU.
leftCentered: La figura predominante se posiciona hacia el lado izquierdo de la imagen, lo que deja el lado derecho relativamente vacío para las superposiciones de IU y texto.

Para ser válidos, incluye al menos uno de estos puestos.

Imágenes de ejemplo con su uso previsto

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

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

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

Una IU para dispositivos móviles con una imagen de póster y una imagen `sceneStill` de 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 que desea para los productos de Google

Los diferentes productos y plataformas de Google requieren tipos de imagen y relaciones de aspecto diferentes. Para garantizar que el contenido se muestre correctamente en todos los productos de Google, les pedimos a los proveedores que 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`	1000x1500
4:3, `iconic` `poster`	800 x 600
1:1, `iconic` `poster`	600x600
3:4, `iconic` `poster`	600x800
16:9, `iconic` `background` [preferido] o `sceneStill`	3840 × 2160
2:3, `iconic` `background` [preferido] o `sceneStill`	1000x1500
3:4, `iconic` `background` (preferido) o `sceneStill`	600x800
1:1, mostrar logotipo (`hasLogo`)	600x600
4:3, Logotipo del canal (`logo`)	800 x 600
1:1, logotipo del canal (`logo`)	600x600
16:9, logotipo del canal (`logo`)	3840 × 2160
9:5, `hasTitle` `logo` (con `transparentBackground` y `forLightBackground` y `forDarkBackground`)	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.
Incluya las imágenes con la resolución más alta que tenga.
El tamaño de los archivos no debe superar los 20 MB.
Se prefieren centered imágenes. Algunos productos pueden usar las imágenes de fondo rightCentered y leftCentered, por lo que puedes incluirlas si las tienes.
Preferimos que las imágenes 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 enumeran en la tabla anterior. De lo contrario, se envía 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 la 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 un póster de película diseñado para 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 en inglés y coreano

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

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