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 debe establecer en ["http://schema.org", {"@language": "xx"}].
|
@type |
Texto | Obligatorio: Siempre se debe establecer en Movie para las películas. |
@id |
URL | Obligatorio: Es el identificador del contenido en formato de URI; por ejemplo, https://example.com/1234abc.@id debe cumplir con los siguientes requisitos:
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 correlacionar el contenido de tu feed con el contenido de las bases de datos de Google.url debe cumplir con los siguientes requisitos:
urlTemplate del objeto target. |
name |
Texto | Obligatorio: Es el nombre de la película.
|
titleEIDR |
Texto | Muy recomendada ¿Por qué? - Un identificador EIDR (Entertainment Identifier Registry) que representa, en el nivel más general o abstracto, una obra cinematográfica o televisiva. Por ejemplo, el EIDR del título de la película conocida como "Los Cazafantasmas" es "10.5240/7EC7-228A-510A-053E-CBB8-J". |
editEIDR |
Texto | Muy recomendada ¿Por qué? - Un identificador EIDR (Entertainment Identifier Registry) que representa una edición específica de una obra cinematográfica o televisiva. Por ejemplo, la película conocida como "Los Cazafantasmas", cuyo EIDR de título 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.
|
sameAs |
URL | Muy recomendada ¿Por qué? Es la URL de 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 | Altamente recomendado: Idioma original de la película en formato BCP 47. |
genre |
Texto | Es una lista ordenada de todos los géneros pertinentes. Por ejemplo : ["Acción", "Moda", "Medio ambiente", "Fútbol"] |
keywords |
Texto | Son las palabras clave o las 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 recomendada ¿Por qué? - Se usa PublicationEvent para especificar el lanzamiento original (global o local) del contenido por parte de un editor, 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 dónde y cuándo.Consulta la sección de ejemplos para obtener detalles y ejemplos. |
releasedEvent.@type |
Texto | Obligatorio: Asegúrate de configurar siempre esta propiedad en uno de los siguientes valores:
|
releasedEvent.location |
País | Obligatorio: Son las regiones asociadas a este evento. En el caso de PublicationEvent, es la región en la que se publicó el contenido.En el caso de FeaturedEvent y ExclusiveEvent, es la región en la que el contenido es destacado o exclusivo.Usa códigos ISO 3166 para los países. Para indicar que es en todo el 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 se estrenó una película en los cines.En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio en la que la entidad es exclusiva o destacada. |
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 destaca la entidad.Si el contenido es perpetuamente exclusivo o destacado, establece endDate en 20 años a partir de la fecha actual. |
releasedEvent.publishedBy |
Organization o Person | Opcional: Es la organización o la persona que publicó esta entidad. |
description |
Texto | Muy recomendada ¿Por qué? Es la sinopsis de la película. Se prefieren las sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
|
duration |
Duración | Duración de la película en formato ISO 8601. Usa el formato "PT00H00M". |
director |
Persona | Muy recomendada ¿Por qué? Son los directores de la película. |
actor |
Persona | Muy recomendada ¿Por qué? Son los miembros del elenco de la película. |
producer |
Organization o Person | Muy recomendada ¿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 avance. Consulta el ejemplo de Trailer. |
trailer.inLanguage |
Texto | Altamente recomendado: Es el idioma del avance en formato BCP 47. |
trailer.url |
URL | Es la URL de un avance alojado públicamente y subido por los estudios de producción respectivos o las fuentes autorizadas. |
trailer.regionsAllowed |
Place | Son 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 recomendada ¿Por qué? - ID externo o de otro tipo que identifica esta entidad de manera inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles. |
review |
Revisión | Calificaciones de opiniones sobre la película |
review.reviewRating |
Calificación | Obligatorio si se proporciona una revisión. Se usa para especificar la calificación que se otorga en la opinión. |
contentRating |
Text o Rating | Obligatorio para el contenido para adultos y muy recomendable en otros casos ¿Por qué? - Clasificación general del contenido Si la clasificación de contenido se proporciona en forma de una cadena de texto, se aceptan dos variaciones:
|
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 clasificación. |
contentRating.advisoryCode |
Texto | Es el código de advertencia del contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual, V = Violencia. |
popularityScore |
PopularityScoreSpecification | Muy recomendada ¿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 otro contenido de tu 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 significa mayor popularidad. |
popularityScore.eligibleRegion |
País | Regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, se debe establecer 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 |
Texto | Obligatorio si corresponde: Completa esta propiedad si la entidad es una variante de Movie. Establece category en cualquiera de los siguientes valores:
|
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 esta es una variante. |
workExample.@type |
Texto | Obligatorio: Siempre se debe establecer en Movie. 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 |
Texto | Obligatorio: Es el nombre de la variante de 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:
|
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
Es 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"
}
Páginas relacionadas
Consulta las siguientes páginas para obtener información sobre los temas relacionados con estas propiedades: