Propiedades del lenguaje de marcado de contenido de películas

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

Tabla de especificaciones

Propiedad Tipo esperado Descripción
@context Text Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
  • Donde"xx" representa el idioma de las strings en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, aunque el idioma de los subtítulos sea en inglés.
@type Text Obligatorio: Siempre se debe establecer 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:
  • Único a nivel global en el catálogo
  • Estático: El ID debe ser fijo y mantener el mismo formato con el paso del tiempo (incluso si cambia la propiedad URL del programa). Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • Tiene el formato de identificador unificado de recursos (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Debido a que la 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: La URL canónica del contenido, que Google utiliza 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 Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta en su lugar la propiedad urlTemplate del objeto target.
name Text Obligatorio: 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 de idioma-país).
titleEIDR Text Muy recomendable ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que represente, de forma más general o abstracta, una obra de película o televisión.

Por ejemplo, el título EIDR de la película conocida como "Cazafantasmas" es "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Text Muy recomendable ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que represente una edición o edición específica de una obra de cine o televisión.

Por ejemplo, la película conocida como "Cazafantasmas" cuyo título EIDR es "10.5240/7EC7-228A-510A-053E-CBB8-J" (p. ej., "10.5240/1F2A-E1C5-680A-14C6-E76B-E5-E7-0-4").

La propiedad titleEIDR es obligatoria cuando se proporciona un EIDR de edición.
potentialAction WatchAction Obligatorio si corresponde: Es un objeto de lenguaje de marcado de acciones 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 lenguaje 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. La entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un Movie puede estar disponible en VoD y en LiveTV.
Use 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é? 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 Text Idioma original de la película en formato BCP 47.
genre Text Una lista ordenada de todos los géneros relevantes. Por ejemplo : [“Acción”, “Moda”, “Entorno”, “Fútbol”]
keywords Text 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é? - Un elemento PublicationEvent se usa para especificar el lanzamiento original (global o local) de un publicador, como la fecha de lanzamiento original de una película.

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

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

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

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

En el caso de FeaturedEvent y ExclusiveEvent, es la región donde el contenido se muestra o es exclusivo.

Usa códigos ISO 3166 para los países. Para indicar en cualquier lugar 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.

Para un PublicationEvent, esto indica la fecha de lanzamiento inicial de esta entidad, como la fecha de estreno en cines de una película por primera vez.

Para ExclusiveEvent y FeaturedEvent, esto representa la fecha de inicio de la creación o exhibición de la entidad.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

Para ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

Para FeaturedEvent, esto representa la última fecha en la que el proveedor presenta la entidad.

Si el contenido es exclusivo o se muestra de forma permanente, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organización o Persona Opcional: La organización o la persona que publicó esta entidad.
description Text Muy recomendable ¿Por qué? Una sinopsis de la película Se prefiere la sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
duration Duración Tiempo de ejecución de la película en formato ISO 8601. Utilice el formato: "PT00H00M".
director Persona Muy recomendable ¿Por qué? Los directores de la película
actor Persona Muy recomendable ¿Por qué? Los miembros del reparto de la película.
producer Organización o Persona Muy recomendable ¿Por qué? Los productores de la película
image ImageObject Obligatorio para Google TV: Las imágenes relacionadas con la película. Si deseas obtener más detalles sobre las propiedades obligatorias y opcionales que debes incluir con image, consulta Propiedades de imágenes.
trailer.description Text Es la descripción del avance. Consulta el ejemplo de Avance.
trailer.inLanguage Text El idioma del avance en formato BCP 47.
trailer.url URL Una URL de un avance alojado públicamente y subido por estudios de producción respectivos o fuentes autorizadas
trailer.regionsAllowed Place Corresponde a las regiones donde se permite el contenido multimedia. Si no se especifica, se supone que se permite en todas partes. Especifica los países en formato ISO 3166.
identifier PropertyValue Muy recomendable ¿Por qué? - Es un ID externo o de otro tipo que identifica inequívocamente esta entidad. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
review Revisión Revisa las calificaciones de la película
review.reviewRating Calificación Obligatorio si se proporciona una revisión. Se usa para especificar la calificación que se proporcionó en la opinión.
contentRating Texto o Calificación Obligatorio para contenido para adultos. De lo contrario, es muy recomendable. ¿Por qué? - Calificación general del contenido: Si la clasificación del contenido se proporciona en una string de texto, se aceptan dos variaciones:
  • La agencia de calificación antepuesto a la calificación con un espacio en blanco en el medio. Por ejemplo, una calificación "PG-13" de la agencia "MPAA" en EE.UU. debe describirse como "MPAA PG-13". Consulte la lista de agencias.
  • Un valor de "CALIFICACIÓN NO SABE" (no distingue mayúsculas de minúsculas) para indicar que no conoce la calificación de la película.
contentRating.author Organización o texto Obligatorio si contentRating usa Rating: El nombre de la agencia de clasificación.
contentRating.ratingValue Text Obligatorio si contentRating usa Rating: El valor de la calificación.
contentRating.advisoryCode Text Es el código de asesoramiento para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Dialogue, FV = Fantasy Violencia, L = Language, S = Sexual Content, V = Violencia.
popularityScore Especificación de PopularityScore Muy recomendable ¿Por qué? Corresponde a una puntuación que utiliza Google, además de otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido con respecto a otro contenido de su catálogo; por lo tanto, la escala de la puntuación debe ser coherente en todos sus feeds, entre todas las entidades de su catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Text Siempre establecida en PopularityScoreSpecification.
popularityScore.value Número Un valor numérico no negativo que indica la popularidad de la entidad; una puntuación más alta significa una mayor popularidad.
popularityScore.eligibleRegion País Regiones donde se aplica esta puntuación de popularidad. Si la puntuación de popularidad es aplicable a nivel global, configúrala en 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 Text Obligatorio si corresponde: Propaga 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 su visualización en el hogar.
  • Theatrical Release: Es una versión que se estrena en cines.
  • International Release: Es una versión editada para publicarse a nivel internacional.
  • Remastered: Es una versión cuyas imágenes, sonido o ambos se mejoran según un estándar más actualizado.
  • Unrated: Es una versión no analizada por la MPAA o por una agencia similar.
  • Director Cut: Es una versión que representa la edición aprobada del director.
  • Extended Cut: Es una versión más larga que el lanzamiento en cines.
workExample Película Especifica las variantes de la película. Incluye esta propiedad en la entidad principal Movie, no en las entidades Movie para las versiones de variantes.
workExample.@id URL Para las variantes Movie, esta propiedad proporciona el @id de la entidad Movie de la que es una variante.
workExample.@type Text Obligatorio: Siempre se establece en Movie. Esto se puede representar como un array para un Movie con múltiples variantes.
workExample.@id URL Obligatorio: Es el @id de la variante Movie.
workExample.name Text Obligatorio: El nombre de la variante de Movie.
workExample.category Text Obligatorio: 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 su visualización en el hogar.
  • Theatrical Release: Es una versión que se estrena en cines.
  • International Release: Es una versión editada para publicarse a nivel internacional.
  • Remastered: Es una versión cuyas imágenes, sonido o ambos se mejoran según un estándar más actualizado.
  • Unrated: Es una versión no analizada por la MPAA o por una agencia similar.
  • Director Cut: Es una versión que representa la edición aprobada del director.
  • Extended Cut: Es una versión más larga que el lanzamiento en cines.

Ejemplo

Película principal

Una película con una variante extendida de corte.

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

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 sobre los temas relacionados con estas propiedades: