Excel - metadatos de clips de formato corto
Referencia campo por campo para la plantilla de Excel de Clip.
Descripción general
Esta referencia describe los campos de la plantilla de metadatos de Excel de Clip. 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 un solo clip. Los campos opcionales sub_type y parent_* describen el clip y su programa principal. Los metadatos deportivos (sport_type, sport_league, sport_teams) son opcionales para los clips en general, pero obligatorios para los clips deportivos. Estos grupos no aparecen en las plantillas de Película y TV; la Referencia XML de Clip incluye los mismos grupos.
Los campos se agrupan en: Información del paquete, Descriptores de contenido, Reparto y equipo de filmación, Activos, Ilustraciones, Disponibilidad, Información del programa principal y Metadatos deportivos.
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 | clip | Obligatorio |
sub_type
Subtipo de contenido del paquete. Usa uno de los valores siguientes para identificar contenido auxiliar o relacionado. Roku no admite conexiones nativas entre el programa principal y el clip, por lo que este campo no crea un vínculo entre los dos activos. Los campos de Información del programa principal permiten describir el programa sin crear un vínculo.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
sub_type | trailer, highlight, making_of, behind_scenes, interview, related, recap, extra | Opcional |
language
Idioma del título, las sinopsis, el video, los subtítulos descriptivos, los subtítulos, los doblajes de audio 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 clip. 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 el clip, 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 un clip. La empresa socia genera o proporciona este ID. Debe coincidir con el Title ID 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 del clip, 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 del clip | Obligatorio |
genres
Clasificación por género del contenido. Cada clip 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
rating_system contiene la autoridad de clasificación (por ejemplo, MPAA), y ratings contiene el valor de clasificación correspondiente (por ejemplo, PG-13) para dicha autoridad. Se debe proporcionar, para cada clip, una clasificación válida de cine o TV de la autoridad de clasificación del territorio en el que estará disponible el contenido. Si no ha sido clasificado 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.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
rating_system | Consulta los valores de clasificación por sistema y país | Obligatorio |
ratings | Consulta los valores de clasificación por sistema y país | Obligatorio |
brief_synopsis
Una sinopsis del clip, 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 del clip, 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 |
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 del clip.
Los metadatos de Excel actualmente admiten solo la función de director para los créditos del equipo de filmación.
| 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 o del 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
La plantilla de Clip incluye un campo de ilustración: una imagen de arte clave de 16:9, según la Especificación de 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 |
Disponibilidad
territory
Códigos de país de los territorios donde 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 del clip. 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 |
Información del programa principal
Estos campos describen el programa del que proviene el clip o con el que está relacionado. Úsalos junto con un valor válido de sub_type. No crean un vínculo navegable ni una relación en la plataforma entre el clip y su programa principal.
parent_type
Tipo de contenido del programa principal del cual se deriva o al cual describe el clip.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_type | episode, movie, series | Opcional |
parent_title
Título del programa principal, si el programa principal es una película o una serie.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_title | Ejemplo: Título de la película o serie principal | Opcional |
parent_runtime
Duración del programa principal, si este es una película o un episodio.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_runtime | Número entero | Opcional |
parent_release_date
Fecha de estreno de la película, episodio o serie principal.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_release_date | Formato ISO 8601: YYYY-MM-DD | Opcional |
parent_tms_id
ID de TMS de la película, episodio o serie principal.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_tms_id | Cualquier ID de TMS válido | Opcional |
parent_series
Título de la serie del programa principal, si este es un episodio.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_series | Ejemplo: Título de la serie principal | Opcional |
parent_season
Número de temporada del programa principal, si este es un episodio.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_season | Número entero mayor que 0 | Opcional |
parent_episode
Número de episodio del programa principal, si este es un episodio.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
parent_episode | Número entero | Opcional |
Metadatos deportivos
Los siguientes campos son opcionales para los clips en general, pero obligatorios para los clips deportivos.
sport_type
Nombre del deporte que aparece en el clip o momento destacado.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
sport_type | Nombre del deporte | Obligatorio para clips deportivos |
sport_league
Nombre de la liga deportiva que aparece en el clip o momento destacado.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
sport_league | Nombre de la liga deportiva | Obligatorio para clips deportivos |
sport_teams
Equipos que aparecen en el clip o momento destacado deportivo. Pueden proporcionarse varios equipos separados por comas.
| Columna de Excel | Valores aceptados | Obligatorio |
|---|---|---|
sport_teams | Lista separada por comas. Ejemplo: Chicago Cubs,St. Louis Cardinals | Obligatorio para clips deportivos |
Updated about 5 hours ago