Propiedades de imágenes

En esta sección, se detallan las propiedades de marcado de contenido de image para películas y programas de TV. Este marcado permite a los proveedores describir 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 entidades Movie, TVSeries, TVSeason o TVEpisode. En la siguiente tabla, se describen las propiedades disponibles para la propiedad image. Observa 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 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, lee contentAttributes.
character Persona

Obligatorio si corresponde: Es un personaje ficticio asociado con la imagen. Esto es obligatorio si contentAttribute incluye castInCharacter.
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 Recommended: Son las regiones en las que se permite la imagen. Si no se especifica, se supone que la imagen se permite en todas partes. Especifica los países en formato ISO 3166.
datePublished Fecha

Obligatorio si corresponde: Es la fecha a partir de la cual estará disponible la imagen, en formato ISO 8601 (incluida la zona horaria).

  • La fecha se puede establecer en el futuro.

Si hay restricciones de tiempo en el uso de la imagen, esta propiedad es obligatoria si la imagen no debe mostrarse antes de la fecha indicada. Si no existe una restricción de este tipo, se puede omitir. Es obligatorio que la imagen correspondiente se proporcione en el feed al menos 7 días antes de la fecha de publicación. Esto mejorará las probabilidades de que el contenido aparezca en las plataformas de Google a tiempo.

expires Fecha

Obligatorio si corresponde: Es la fecha en que dejará de estar disponible la imagen, 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 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 está diseñado para usarse en todas partes. 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 Recommended: Es el 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. A menudo, es una renderización artística.
  • sceneStill: Es un extracto de imagen del programa.
  • castInCharacter: Una foto de un miembro del elenco tal como aparece en el personaje. Si usas este valor, también incluye la propiedad character para identificar el carácter 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 uno y solo uno de estos tipos.

  • poster: Es una imagen de póster del programa. En las IU de computadoras, se pueden usar en carruseles. Estos pueden incluir o no 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 que sea válido, incluye como máximo uno de estos usos recomendados.

Adecuación del tamaño

  • smallFormat: Es una imagen adecuada para pantallas más pequeñas, como teléfonos celulares. El texto o los logotipos de la imagen son 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.

Adecuación 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 un valor de idoneidad de fondo como máximo.

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 de derechos de autor visible.
  • noCopyright: La imagen no incluye un aviso de derechos de autor visible. Por lo general, Google no puede usar esas imágenes sin modificaciones.
  • hasMatte: La imagen tiene un efecto mate. Puede ser horizontal (letterbox), vertical (pillarbox) o ambas (windowbox). A veces, las imágenes se aplican un efecto mate para que se ajusten a una relación de aspecto. Por lo general, Google no puede usar esas imágenes sin modificaciones.
  • noMatte: La imagen no tiene un efecto 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, y nada más.

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

Posición de la figura predominante

  • centered: La figura predominante se ubica 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 las superposiciones de texto y 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 IU.

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

Ejemplos de imágenes 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 fondo iconic.
Una IU para dispositivos móviles con una imagen de póster y una imagen de fondo sceneStill.

Imágenes de ejemplo y sus atributos de contenido

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 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 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 1,000 x 1,500
4:3, iconic poster 800x600
1:1, iconic poster 600 x 600

3:4, iconic poster

 600 × 800

16:9, iconic background [preferido] o sceneStill

 3840 × 2160

2:3, iconic background [preferido] o sceneStill

 1,000 x 1,500

3:4, iconic background [preferido] 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

Cuando envíes imágenes, se aplicarán los siguientes lineamientos:

  1. Las imágenes deben estar en formato JPEG, PNG o WebP.
  2. Incluye las imágenes con la resolución más alta que tengas.
  3. El tamaño de los archivos no debe superar los 20 MB.
  4. Se prefieren las imágenes centered. Algunos productos también pueden usar las imágenes de fondo rightCentered y leftCentered, por lo que puedes incluirlas si las tienes.
  5. Preferimos las imágenes que funcionan para smallFormat y largeFormat.
  6. Puedes incluir tamaños de imagen además de los que se indican en la tabla anterior.
  7. 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 muestra 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 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 se restringió 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 del póster de la película 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 de gran formato en 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"]
      }
    ]
  }
}

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