Excel - campos de metadatos de películas
Referencia campo por campo para la plantilla de Excel de Película.
Descripción general
Esta referencia describe los campos de la plantilla de metadatos de Excel de Película. Para descargar la plantilla y consultar las reglas de formato, estructura, límites de filas y tipo de archivo, consulta la Descripción general de metadatos de Excel.
Entrega el libro y los archivos que referencia mediante el método de Aspera o S3 aprobado durante la incorporación.
Cada fila representa una sola película. La columna language indica el idioma del título, las sinopsis, el video, los subtítulos descriptivos, los subtítulos, el doblaje de audio y las ilustraciones de esa fila. Consulta la Descripción general de metadatos de Excel.
Los campos se agrupan a continuación en: Información del paquete, Descriptores de contenido, Cortes publicitarios y puntos de referencia, Reparto y equipo de filmación, Activos, Ilustraciones y Disponibilidad.
Información del paquete
provider
Nombre del propietario del contenido, estudio o cadena.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
provider | Ejemplo: Roku Originals | Obligatorio |
contentType
Tipo de contenido del paquete.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
contentType | film | Obligatorio |
language
Idioma del título, las sinopsis, el video, los subtítulos descriptivos, los subtítulos, los doblajes de audio y/o las ilustraciones que se indican en la fila. Debe ajustarse a un código de idioma admitido. Se recomienda incluir un código de región para distinguir variantes como es-MX y es-ES.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
language | Valor de idioma válido | Obligatorio |
original_spoken_language
Idioma original de producción del título. El valor debe usar un código de idioma admitido. Se recomienda incluir un código de región.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
original_spoken_language | Valor de idioma válido | Obligatorio |
country_of_origin
El país principal donde se produjo la película, y donde están establecidos los principales creadores, el equipo de filmación y los productores. Debe ajustarse a un código ISO 3166-1 alfa-2 admitido.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
country_of_origin | Código de país válido de 2 caracteres según ISO 3166-1 alfa-2 | Preferido |
asset_id
Identificador único e inalterable de una película. La empresa socia genera o proporciona este ID. Debe coincidir con el ID del título en el documento de Avails para facilitar el seguimiento durante el procesamiento en Roku. Límite de 50 caracteres.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
asset_id | Solo caracteres alfanuméricos, guiones y guiones bajos. 50 caracteres como máximo. | Obligatorio |
eidr
ID de EIDR, si existe uno.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
eidr | Cualquier ID de EIDR válido | Opcional |
tms_id
ID de Gracenote, si existe uno.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
tms_id | Cualquier ID de TMS válido | Opcional |
Descriptores de contenido
title
Título de la película, en el idioma definido en la columna language. Incluye únicamente el nombre como debe aparecer en la plataforma. No agregues información entre paréntesis que no forme parte del título (por ejemplo, (Clásica), (1987), (Temporada 1), (HD)).
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
title | Ejemplo: Título de película | Obligatorio |
genres
Clasificación por género del contenido. Cada película debe entregarse con al menos un género admitido. Consulta la lista enumerada de géneros.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
genres | Consulta la lista enumerada. No más de 10 géneros por título. | Obligatorio |
tags
Etiquetas de texto libre que describen el contenido además de su género. El equipo editorial y el motor de recomendaciones de Roku las usan para ayudar a los usuarios a encontrar contenido. No hay límite de cantidad ni una lista predefinida de etiquetas. Se distinguen mayúsculas y minúsculas, por lo que debes mantener un uso consistente (por ejemplo, "Rom-Com" y "rom-com" son dos etiquetas distintas).
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
tags | Cualquier cadena de menos de 50 caracteres | Muy recomendable |
runtime
Duración total del contenido, en minutos enteros.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
runtime | Solo números enteros. Ejemplo: 90 | Obligatorio |
release_date
Fecha original en la que el contenido estuvo disponible por primera vez en cualquier presentación. Debe incluir, como mínimo, un año de estreno correcto.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
release_date | Formato ISO 8601: YYYY-MM-DD | Obligatorio |
rating_system y ratings
Se debe proporcionar, para cada película, una clasificación válida de cine o TV emitida por la autoridad de clasificación (ratingSystem) del territorio en el que estará disponible el contenido. Si no ha sido clasificada por la autoridad oficial de ese territorio, usa en su lugar una clasificación válida de USA_PR, según las pautas de tvguidelines.org (no existe un organismo oficial de clasificación para USA_PR).
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
rating_system | Consulta valores de clasificación por sistema y país | Obligatorio |
ratings | Consulta valores de clasificación por sistema y país | Obligatorio |
brief_synopsis
Una sinopsis de la película, en el idioma definido en la columna language. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
brief_synopsis | Hasta 100 caracteres | Obligatorio para la distribución en Linear OTT |
short_synopsis
Una sinopsis breve del contenido, en el idioma definido en la columna language. Límite de 250 caracteres.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
short_synopsis | Sinopsis de 250 caracteres | Obligatorio |
long_synopsis
Una sinopsis larga opcional del contenido, en el idioma definido en la columna language. Límite de 500 caracteres.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
long_synopsis | Sinopsis de 500 caracteres | Opcional |
localized_brief_synopsis
Una sinopsis localizada de la película, en el idioma definido en la columna localized_language. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
localized_brief_synopsis | Hasta 100 caracteres | Obligatorio para la distribución en Linear OTT |
closed_captions
Indica si el título entregado contiene subtítulos descriptivos. El indicador Y/N es obligatorio para todo el contenido destinado a Roku Channel en EE. UU. Proporcionar este indicador no obliga por sí mismo a entregar un archivo de subtítulos descriptivos; la empresa socia determina si son obligatorios para esa entrega.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
closed_captions | Y o N | Obligatorio |
closed_captions_exemption
Código de exención de la FCC para el requisito de subtítulos descriptivos. Obligatorio en EE. UU. si closed_captions = N.
| Código | Definición |
|---|---|
| 1 | El contenido nunca se emitió por televisión en Estados Unidos. |
| 2 | El contenido solo se emitió por televisión en Estados Unidos sin subtítulos descriptivos. |
| 3 | El contenido no se ha emitido por televisión en Estados Unidos con subtítulos descriptivos desde el 30 de septiembre de 2012. |
| 4 | El contenido no consiste en programación de video de larga duración. |
| 5 | El contenido no pertenece a una categoría de programación en línea que requiere subtítulos descriptivos según las normas de la FCC (47 C.F.R. § 79.4(b)). |
| 6 | La FCC o el Congreso de EE. UU. concedieron una exención de los requisitos de subtítulos descriptivos para este contenido. |
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
closed_captions_exemption | 1, 2, 3, 4, 5, 6 | Obligatorio en EE. UU. si closed_captions = N |
Cortes publicitarios y puntos de referencia
ad_breaks
Identifica los cortes publicitarios para contenido financiado con anuncios. Los valores deben tener una precisión de milisegundos. Si el video contiene fotogramas negros para un corte publicitario, proporciona el código de tiempo en el punto medio de ese intervalo. Este campo no es obligatorio para SVOD, pero Roku puede ingerir datos con precisión de fotogramas si están disponibles.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
ad_breaks | HH:MM:SS.sss | Preferido |
cue_points
Identifica los tiempos de inicio y fin de los créditos iniciales, los resúmenes, los créditos finales y el material detrás de cámaras. Los valores deben tener una precisión de milisegundos.
Escribe los puntos de referencia como una única cadena de texto separada por comas en una celda. En XML, esta información se proporciona en elementos
cuePointanidados; consulta la Referencia XML de Película.
Formato: una lista separada por comas de pares type=startTime>endTime.
Ejemplo:
intro=00:05:10.253>00:07:15.123,recap=00:01:12.456>00:03:12.052| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
cue_points | Formato: type=HH:MM:SS.sss>HH:MM:SS.sss. Valores type permitidos: ad overlay, behind the scenes, intro, recap, end | Opcional |
Reparto y equipo de filmación
cast
Nombres de los miembros del reparto.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
cast | Lista de Nombre Apellido separados por comas | Preferido |
director
Nombre del director o los directores de la película.
Los metadatos de Excel actualmente admiten solo la función de director para los créditos del equipo de filmación. La Referencia XML de Película incluye otras funciones disponibles en XML.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
director | Lista de Nombre Apellido separados por comas | Preferido |
Activos
video_file_name
Nombre de archivo del video, en el idioma definido en la columna language, entregado mediante el método aprobado. Solo se permite un video por asset_id. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
video_file_name | Ejemplo: movieVideoFile.mov | Obligatorio |
video_file_language
Idioma principal del diálogo hablado y/o el texto visible del archivo de video. Si no hay diálogo ni texto visible, usa el idioma que habla la audiencia prevista. También aplica a caption_file_name y forced_subtitle_file_name. Solo se permite un idioma.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
video_file_language | Un valor de idioma válido | Obligatorio |
audio_layout
Descriptor de diseño de audio para el archivo de video entregado.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
audio_layout | stereoOnly, surroundOnly, stereoPlusSurround, surroundPlusStereo | Opcional |
descriptive_audio_file_name
Solo para archivos de audio descriptivo. Nombre de archivo del audio descriptivo, en el idioma definido en descriptive_audio_language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
descriptive_audio_file_name | Ejemplo: movieDubFile.wav | Obligatorio al proporcionar un archivo de audio descriptivo sidecar con fines de accesibilidad |
descriptive_audio_language
Solo para archivos de audio descriptivo. Idioma principal de la pista de diálogo hablado del archivo de audio. Solo se permite un idioma.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
descriptive_audio_language | Un valor de idioma válido | Obligatorio al proporcionar archivos de audio descriptivo |
caption_file_name
Roku considera muy recomendable entregar subtítulos descriptivos. La empresa socia es responsable de determinar si son obligatorios para una entrega específica.
Si se proporcionan, indica el nombre del archivo de subtítulos descriptivos entregado mediante el método aprobado, en el idioma definido en la columna language. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales. Su idioma se deriva de video_file_language.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
caption_file_name | Ejemplo: movieCaptions.srt | Muy recomendable |
forced_subtitle_file_name
Nombre de archivo del subtítulo narrativo forzado, en el idioma definido en video_file_language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales. Su idioma se deriva de video_file_language.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
forced_subtitle_file_name | Ejemplo: movieForcedSubtitle.srt | Obligatorio al proporcionar subtítulos narrativos forzados |
Ilustraciones
keyart_file_name
Nombre de archivo de la imagen de arte clave con texto, en el idioma definido en la columna language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
keyart_file_name | Ejemplo: movieKeyArt.jpg | Obligatorio |
background_file_name
Nombre de archivo de la imagen de fondo sin texto, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
background_file_name | Ejemplo: movieBGimage.jpg | Preferido |
boxcover_file_name
Nombre de archivo de la imagen de carátula con texto en 3:4 para la película, en el idioma definido en la columna language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
boxcover_file_name | Ejemplo: movieBoxArt.jpg | Obligatorio para la distribución en Howdy |
poster_file_name
Nombre de archivo de la imagen de portada con texto, en el idioma definido en la columna language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
poster_file_name | Ejemplo: moviePoster.jpg | Preferido |
Disponibilidad
Los cuatro campos siguientes son preferidos, como se indica en las tablas. Ninguno es obligatorio.
territory
Códigos de país del territorio en el que está disponible el contenido. Se permiten varios códigos de país separados por comas, siempre que vod_type, license_start_date y license_end_date sean idénticos en todos ellos.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
territory | US, CA, GB, MX | Preferido |
vod_type
Tipo de monetización de la película. Se permiten varios valores separados por comas, siempre que territory, license_start_date y license_end_date sean idénticos en todos ellos.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
vod_type | Ejemplo: avod, svod, avod,svod | Preferido |
license_start_date
Fecha de inicio de la disponibilidad del contenido. La fecha debe ser anterior a license_end_date; las fechas no deben ser iguales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
license_start_date | Formato ISO 8601: YYYY-MM-DDTHH:MM:SS | Preferido |
license_end_date
Fecha de finalización de la disponibilidad del contenido. La fecha debe ser posterior a license_start_date; las fechas no deben ser iguales.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
license_end_date | Formato ISO 8601: YYYY-MM-DDTHH:MM:SS | Preferido |
Updated about 5 hours ago