Propiedades de marcado del contenido de las películas

En esta sección, se proporcionan los detalles de las propiedades de marcado de contenido para el tipo de entidad Movie.

Tabla de especificaciones

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.org", {"@language": "xx"}]
    .
  • Donde"xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es inglés.
@type Texto Obligatorio: Siempre se establece en Movie para las películas.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en tu catálogo.
  • Estático: El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
url URL Obligatorio: Es la URL canónica del contenido, que Google usa para hacer coincidir el contenido de tu feed con el contenido de las bases de datos de Google.
url debe cumplir con los siguientes requisitos:
  • url debe ser único a nivel global
  • url debe contener una URL canónica que funcione y que Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
name Texto Obligatorio: Es el nombre de la película.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de Varios idiomas y regiones.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
titleEIDR Texto Muy recomendable ¿Por qué? - Un identificador de EIDR (registro de identificadores de entretenimiento) que represente, en el nivel más general o abstracto, una obra de cine o televisión.

Por ejemplo, el títuloEIDR de la película conocida como “Ghostbusters” es “10.5240/7EC7-228A-510A-053E-CBB8-J”.
editEIDR Texto Muy recomendable ¿Por qué? - Un identificador de EIDR (registro de identificadores de entretenimiento) que representa una edición específica de una obra cinematográfica o televisiva.

Por ejemplo, la película conocida como “Ghostbusters”, cuyo títuloEIDR es “10.5240/7EC7-228A-510A-053E-CBB8-J”, tiene varias ediciones, p.ej., “10.5240/1F2A-E1C5-680A-14C6-E76B-I” y “10.5240/8A35-3BEE-6497-5D12-9E4F-3”. La propiedad

titleEIDR es obligatoria cuando se proporciona editEIDR.
potentialAction WatchAction Obligatorio si corresponde: Es un objeto de marcado de acción que proporciona los detalles de la acción.
  • Si el contenido está disponible en video on demand (VoD), esta propiedad es obligatoria. El objeto de marcado de acción debe proporcionar el vínculo directo del contenido.
  • Si el contenido está disponible en un canal de LiveTV, esta propiedad es opcional. En su lugar, la entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un Movie puede estar disponible en VoD y LiveTV.
Usa un array para especificar diferentes vínculos directos en varias regiones. Consulta el ejemplo de Varios idiomas y regiones.
sameAs URL Muy recomendable ¿Por qué? Es una URL a una página web de referencia que puede identificar la película, por ejemplo, la página de Wikipedia de la película. Debe ser diferente de la propiedad url.
inLanguage Texto Es el idioma original de la película en formato BCP 47.
genre Texto Es una lista ordenada de todos los géneros relevantes. Por ejemplo : ["Acción", "Moda", "Entorno", "Fútbol"]
keywords Texto Palabras clave o etiquetas que se usan para describir este contenido. También se permite un array de palabras clave. Por ejemplo, ["feature, biography"] puede ser un array de palabras clave para describir el contenido.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendable ¿Por qué? - Se usa un PublicationEvent para especificar el lanzamiento original (global o local) de contenido por parte de un publicador, como la fecha de lanzamiento original en cines de una película.

Además, usa FeaturedEvent para indicar que tu servicio comercializa este contenido como original, destacado, especial, etcétera.

ExclusiveEvent especifica que tu servicio tiene derechos de distribución exclusivos y, además, incluye dónde y cuándo.

Consulta la sección de ejemplos para obtener detalles y ejemplos.
releasedEvent.@type Texto Obligatorio: Asegúrate de configurar esta propiedad siempre en una de las siguientes opciones:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obligatorio: Son las regiones asociadas con este evento.

Para un PublicationEvent, esta es la región donde se publicó el contenido.

Para FeaturedEvent y ExclusiveEvent, esta es la región donde el contenido es destacado o exclusivo.

Usa los códigos ISO 3166 para los países. Para indicar todos los lugares del mundo, configúralo como EARTH.
releasedEvent.startDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent: Es la fecha de inicio de la publicación de la entidad.

En el caso de un PublicationEvent, indica la fecha de lanzamiento inicial de esta entidad, como la fecha en que una película se estrenó por primera vez en cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio de la exclusividad o la publicación destacada de la entidad.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent: Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

En el caso de ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

En el caso de FeaturedEvent, representa la última fecha en la que el proveedor destacó la entidad.

Si el contenido es exclusivo o destacado de forma perpetua, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o persona que publicó esta entidad.
description Texto Muy recomendable ¿Por qué? Es un resumen de la película. Se prefieren los sinopsis de la trama a los resúmenes de hechos. Tiene un límite de 300 caracteres.
duration Duración Es la duración de la película en formato ISO 8601. Usa el formato "PT00H00M".
director Persona Muy recomendable ¿Por qué? Son los directores de la película.
actor Persona Muy recomendable ¿Por qué? Son los miembros del elenco de la película.
producer Organization o Person Muy recomendable ¿Por qué? Son los productores de la película.
image ImageObject Obligatorio para Google TV: Son las imágenes relacionadas con la película. Para obtener más detalles sobre las propiedades obligatorias y opcionales que se deben incluir con image, consulta Propiedades de imagen.
trailer.description Texto Es la descripción del tráiler. Consulta el ejemplo de Trailer.
trailer.inLanguage Texto Es el idioma del tráiler en formato BCP 47.
trailer.url URL Es la URL de un avance alojado públicamente y subido por los estudios de producción o las fuentes autorizadas correspondientes.
trailer.regionsAllowed Place Indica las regiones en las que se permite el contenido multimedia. Si no se especifica, se supone que está permitido en todas partes. Especifica los países en formato ISO 3166.
identifier PropertyValue Muy recomendable ¿Por qué? - ID externo o algún otro ID que identifica esta entidad de forma inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
review Revisión Revisa las clasificaciones de la película
review.reviewRating Calificación Obligatorio si se proporciona una revisión. Se usa para especificar la calificación que se otorgó en la opinión.
contentRating Text o Rating Obligatorio para el contenido para adultos, muy recomendable en otros casos ¿Por qué? - Clasificación general del contenido Si la clasificación del contenido se proporciona en forma de una cadena de texto, se aceptan dos variaciones:
  • La agencia de calificación se agrega al principio de la calificación con un espacio en blanco en el medio. Por ejemplo, una clasificación "PG-13" de la agencia "MPAA" en EE.UU. se debe describir como "MPAA PG-13". Consulta la lista de agencias.
  • Un valor de "RATING NOT KNOWN" (sin distinción entre mayúsculas y minúsculas) para indicar que no conoces la clasificación de la película.
contentRating.author Organization Obligatorio si contentRating usa Rating: Es el nombre de la agencia de clasificación.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la calificación.
contentRating.advisoryCode Texto Es el código de advertencia para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual y V = Violencia.
popularityScore PopularityScoreSpecification Muy recomendable ¿Por qué? Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con el resto del catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Texto Siempre se establece en PopularityScoreSpecification.
popularityScore.value Número Es un valor numérico no negativo que indica la popularidad de la entidad. Una puntuación más alta indica una mayor popularidad.
popularityScore.eligibleRegion País Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, configúrala como EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
Note: La popularidad específica de la configuración regional tiene prioridad sobre la popularidad global (EARTH).
category Texto Obligatorio si corresponde: Completa esta propiedad si la entidad es una variante de Movie. Establece category en cualquiera de los siguientes valores:
  • Home Release: Es una versión que se vende o alquila para ver en casa.
  • Theatrical Release: Es una versión estrenada en cines.
  • International Release: Es una versión editada para su lanzamiento internacional.
  • Remastered: Es una versión cuyas imágenes, sonido o ambos se mejoraron a un estándar más actualizado.
  • Unrated: Es una versión que no se proyectó en la MPAA ni en una agencia similar.
  • Director Cut: Es una versión que representa la edición aprobada por el director.
  • Extended Cut: Es una versión más larga que la versión cinematográfica.
workExample Película Especifica las variantes de la película. Incluye esta propiedad en la entidad Movie principal, no en las entidades Movie de las versiones de variantes.
workExample.@id URL Para las variantes de Movie, esta propiedad proporciona el @id de la entidad Movie de la que es una variante.
workExample.@type Texto Obligatorio: Siempre se establece en Movie. Esto se puede representar como un array para un Movie con varias variantes.
workExample.@id URL Obligatorio: Es el @id de la variante Movie.
workExample.name Texto Obligatorio: Es el nombre de la variante Movie.
workExample.category Texto Obligatorio: Es el tipo de variante de película de una versión en particular. Establece la categoría en cualquiera de las siguientes opciones:
  • Home Release: Es una versión que se vende o alquila para ver en casa.
  • Theatrical Release: Es una versión estrenada en cines.
  • International Release: Es una versión editada para su lanzamiento internacional.
  • Remastered: Es una versión cuyas imágenes, sonido o ambos se mejoraron a un estándar más actualizado.
  • Unrated: Es una versión que no se proyectó en la MPAA ni en una agencia similar.
  • Director Cut: Es una versión que representa la edición aprobada por el director.
  • Extended Cut: Es una versión más larga que la versión cinematográfica.

Ejemplo

Película principal

Una película con una variante de corte extendido.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

Variante de corte extendido

La versión extendida de la película principal.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}

Consulta las siguientes páginas para ver los temas relacionados con estas propiedades: