En esta sección, se proporcionan los detalles de las propiedades de lenguaje de marcado del contenido para el tipo de entidad Movie.
Tabla de especificación
| Propiedad | Tipo esperado | Descripción |
|---|---|---|
@context |
Texto | Obligatorio: Siempre se establece en ["http://schema.org", {"@language": "xx"}]
|
@type |
Texto | Obligatorio: Siempre se establece en Movie para las películas. |
@id |
URL | Obligatorio: El identificador del contenido en formato 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 información. |
url |
URL | Obligatoria: 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:
urlTemplate del objeto objetivo. |
name |
Texto | Obligatorio: El nombre de la película.
|
titleEIDR |
Texto | altamente recomendado ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que representa, 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 “Cazafantasmas” es “10.5240/7EC7-228A-510A-053E-CBB8-J”. |
editEIDR |
Texto | altamente recomendado ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que representa 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í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 lenguaje de marcado de acciones que proporciona los detalles de la acción.
|
sameAs |
URL | altamente recomendado ¿Por qué? Una URL a una página web de referencia que pueda identificar la película por ejemplo, la página de Wikipedia de la película. Debe ser distinto 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 | Son las palabras clave o etiquetas utilizadas 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 |
altamente recomendado ¿Por qué? - Se usa un PublicationEvent para especificar el lanzamiento original (global o local) de contenido de un editor, como la fecha de estreno en cines 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 e incluye dónde y cuándo.Consulta la sección de ejemplos para obtener más detalles y ejemplos. |
releasedEvent.@type |
Texto | Obligatorio: Asegúrate de establecer siempre esta propiedad en una de las siguientes opciones:
|
releasedEvent.location |
País | Obligatorio: Indica las regiones asociadas con este evento. En el caso de un PublicationEvent, es la región donde se publicó el contenido.Para FeaturedEvent y ExclusiveEvent, es la región donde el contenido se destaca o es exclusivo.Usa códigos ISO 3166 para los países. Para indicar cualquier lugar del mundo, establécelo en EARTH. |
releasedEvent.startDate |
Date o DateTime | Recomendada (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 de estreno de una película en cines.En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio en que la entidad es exclusiva o presentada. |
releasedEvent.endDate |
Date o DateTime | Recomendado (obligatorio para ExclusiveEvent): Esto solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.Para ExclusiveEvent, representa la fecha de vencimiento de los derechos del contenido.Para FeaturedEvent, representa la última fecha en la que el proveedor presenta la entidad.Si el contenido es exclusivo o se destaca permanentemente, 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 | altamente recomendado ¿Por qué? Una sinopsis de la película. Se prefieren los resúmenes de tramas en lugar de 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. Usa el formato “PT00H00M”. |
director |
Persona | altamente recomendado ¿Por qué? El director de la película. |
actor |
Persona | altamente recomendado ¿Por qué? Los miembros del reparto de la película. |
producer |
Organization o Person | altamente recomendado ¿Por qué? Los productores de la película. |
image |
ImageObject | Obligatorio para Google TV: 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 imágenes. |
trailer.description |
Texto | Es la descripción del avance. Consulta el ejemplo de Avances. |
trailer.inLanguage |
Texto | El idioma del avance en formato BCP 47. |
trailer.url |
URL | Una URL de un avance alojado públicamente y subido por los estudios de producción respectivos o las fuentes autorizadas. |
trailer.regionsAllowed |
Place | Las regiones donde 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 | altamente recomendado ¿Por qué? - ID externo o de otro tipo que identifique a esta entidad de manera inequívoca Se permiten múltiples identificadores. Consulta la sección Propiedades de los identificadores para obtener más detalles. |
review |
Revisión | Calificaciones de opiniones para la película |
review.reviewRating |
Calificación | Obligatorio si se proporciona una revisión. Se usa para especificar la calificación otorgada en la opinión. |
contentRating |
Text o Rating | Obligatorio para el contenido para adultos; de lo contrario, se recomienda mucho ¿Por qué? - Clasificación general del contenido. Si la clasificación del contenido se proporciona en forma de string de texto, se aceptan dos variaciones:
|
contentRating.author |
Organization | Obligatorio si contentRating usa Rating: Es el nombre de la agencia de calificación. |
contentRating.ratingValue |
Texto | Obligatorio si contentRating usa Rating: El valor de la calificación. |
contentRating.advisoryCode |
Texto | Es el código de asesoría del contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia de fantasía, L = Idioma, S = Contenido sexual, V = Violencia. |
popularityScore |
PopularityScoreSpecification | altamente recomendado ¿Por qué? Es una puntuación que Google utiliza, junto con otros indicadores, para determinar qué contenido multimedia se debe 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 en 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 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 puede aplicar a nivel global, establécela 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: Propaga esta propiedad si la entidad es una variante de Movie. Configura 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 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 objeto Movie con múltiples variantes. |
workExample.@id |
URL | Obligatorio: 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 específica. Establece la categoría en cualquiera de las siguientes opciones:
|
Ejemplo
Película principal
Es 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: