Metadata

Son los metadatos de un activo. Algunos campos de metadatos solo son válidos para ciertos tipos de recursos.

Representación JSON 
{
  "customId": string,
  "title": string,
  "notes": string,
  "description": string,
  "genre": [
    string
  ],
  "isrc": string,
  "grid": string,
  "artist": [
    string
  ],
  "label": string,
  "upc": string,
  "album": string,
  "infoUrl": string,
  "iswc": string,
  "category": string,
  "copyrightDate": {
    object (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
Campos
customId

string

Es un valor único que tú, el proveedor de metadatos, usas para identificar un activo. El valor puede ser un ID único que creaste para el activo o un identificador estándar, como un ISRC. El valor tiene una longitud máxima de 64 bytes y puede contener caracteres alfanuméricos, guiones (-), guiones bajos (_), puntos (.), símbolos "arroba" (@) o barras diagonales (/).
title

string

Es el título o nombre del activo. El valor tiene una longitud máxima de 255 bytes. Este valor es obligatorio para los activos que se indican a continuación y opcional para todos los demás:

  • Mostrar recursos
  • Recursos de episodios vinculados a un programa
  • Activos de películas que aparecen en la categoría Películas de YouTube
  • Grabaciones de sonido incluidas en el programa AudioSwap
notes

string

Es información adicional que no se asigna directamente a uno de los otros campos de metadatos. La longitud máxima de este campo es 255 bytes.
description

string

Es una descripción del activo. La descripción puede mostrarse en YouTube o en el CMS. La longitud máxima de este campo es 5000 bytes.
genre[]

string

En este campo, se especifica un género que se puede usar para clasificar un activo. Los activos se pueden clasificar en más de un género, y YouTube usa diferentes conjuntos de géneros para clasificar los distintos tipos de activos. Por ejemplo, Soaps podría ser un género válido para un programa, pero no para una película o una grabación de sonido.

  • Mostrar recursos
  • Activos de películas que aparecen en la categoría Películas de YouTube
  • Grabaciones de sonido incluidas en el programa AudioSwap
isrc

string

Es el ISRC (código de grabación estándar internacional) de un activo de video musical o grabación de sonido. El valor de este campo debe contener exactamente 12 caracteres alfanuméricos.
grid

string

Es el identificador de lanzamiento global (GRID) de un video musical o una grabación de sonido. El valor de este campo debe contener exactamente 18 caracteres alfanuméricos.
artist[]

string

Es el artista asociado a un activo de video musical o grabación de sonido. Este campo solo es válido para los activos de videos musicales y grabaciones de sonido. Se requiere para las grabaciones de sonido incluidas en el programa AudioSwap.
label

string

Es el sello discográfico que lanzó un activo de grabación de sonido. Este campo solo es válido para los activos de grabación de sonido y tiene una longitud máxima de 255 bytes.
upc

string

Es el UPC (código universal de producto) asociado con el activo.
album

string

Álbum en el que se incluye un activo de grabación de sonido. Este campo solo es válido para los activos de grabación de sonido y tiene una longitud máxima de 255 bytes.
infoUrl

string

Es una URL oficial asociada con el activo. La longitud máxima de este campo es 1536 bytes. No envíes una URL de 1,537 bytes. Tus esfuerzos serían inútiles.
iswc

string

Es el ISWC (Código de obra musical estándar internacional) de un activo de composición. El valor del campo debe contener exactamente 11 caracteres con el siguiente formato: una letra (T) seguida por 10 dígitos.
category

string

Es la categoría de este recurso.
copyrightDate

object (Date)

Es la fecha en la que se establecieron los derechos de autor de este activo. *
startYear

integer (uint32 format)

Es el primer año en que se emitió un programa de televisión. Este valor es obligatorio y solo se usa para los activos de la campaña de Publicidad en Búsqueda.
endYear

integer (uint32 format)

Es el último año en que se emitió un programa de televisión. Este valor solo se usa para los activos de la campaña de Show, para los que es opcional. No especifiques un valor si aún se están creando episodios nuevos del programa.
episodesAreUntitled

boolean

Este valor indica que los episodios asociados con un activo de programa o de temporada en particular no tienen título. Un programa (o una temporada) sin título tiene episodios que se identifican por su número o fecha. Si este campo se establece en true, YouTube optimizará el título que se muestra para los episodios asociados.
keyword[]

string

Es una lista de hasta 100 palabras clave asociadas con un activo de programa. Este campo es obligatorio y solo se usa para los activos de programas.
tmsId

string

Es el ID de TMS (Tribune Media Systems) del activo.
showCustomId

string

Es el customId del recurso de programa con el que se asocia un recurso de temporada o episodio. Es obligatorio para los activos de episodios y temporadas que aparecen en la categoría Programas de YouTube y no es válido para otros tipos de activos. Este campo tiene una longitud máxima de 64 bytes y puede contener caracteres alfanuméricos, guiones (-), guiones bajos (_), puntos (.), símbolos "arroba" (@) o barras (/).
showTitle

string

Es el nombre del programa asociado con un episodio. Nota: Esta etiqueta solo se usa y es válida para los episodios que no están asociados con elementos de programa, y permite que esos elementos sigan mostrando el título del programa en la sección de metadatos de activo del CMS. La longitud máxima de este campo es 120 bytes.
seasonNumber

string

Número de temporada que identifica un activo de temporada o número de temporada asociado a un activo de episodio. La longitud máxima de este campo es de 5 bytes.
episodeNumber

string

Es el número de episodio asociado a un activo de episodio. Este campo es obligatorio y solo se usa para los activos de episodios que están vinculados a los activos de programas. Tiene una longitud máxima de 5 bytes.
writer[]

string

Es una lista que identifica a los escritores asociados con el activo. Puedes especificar hasta 50 escritores para un activo.
actor[]

string

Es una lista que identifica a los actores asociados con el activo. Puedes especificar hasta 50 actores para un activo.
director[]

string

Es una lista que identifica a los directores asociados con el activo. Puedes especificar hasta 50 directores para un activo.
producer[]

string

Es una lista que identifica a los productores del activo. Puedes especificar hasta 50 productores para un activo.
releaseDate

object (Date)

Fecha en la que se lanzó públicamente un activo. En el caso de los recursos de temporada, este valor especifica la primera fecha en la que se emitió la temporada. No se pueden especificar fechas anteriores al año 1902. Este valor es válido para los activos de episodios, temporadas, películas, videos musicales y grabaciones de sonido. Es obligatorio para los activos que se indican a continuación y, de lo contrario, es opcional:

  • Recursos de episodios vinculados a un programa
  • Activos de películas que aparecen en la categoría Películas de YouTube
spokenLanguage

string

El idioma hablado que predomina en el video. El valor puede ser cualquier código de idioma ISO 639-1 de dos letras. Este valor solo se usa para los activos de episodios y películas, y no es válido para otros tipos de activos.
subtitledLanguage[]

string

Es una lista de los idiomas para los que el video tiene una pista de subtítulos independiente o subtítulos integrados que forman parte del video. Cada valor de la lista debe ser un código de idioma ISO 639-1 de dos letras. Este valor solo se usa para los activos de episodios y películas, y no es válido para otros tipos de activos.
isan

string

Es el ISAN (International Standard Audiovisual Number) del activo. Este valor solo se usa para los recursos de episodios y películas, y es opcional en ambos casos. El valor contiene 26 caracteres, los cuales incluyen los 24 caracteres hexadecimales del ISAN y dos caracteres de verificación, en el siguiente formato:

  • Los primeros 16 caracteres del valor de la etiqueta contienen los caracteres hexadecimales que especifican los componentes "raíz" y "episodio" del ISANcharacters in the tag value contain hexadecimal characters specifying the 'root' and 'episode' components of the ISAN.
  • El decimoséptimo carácter es un carácter de verificación (una letra de la A a la Z).
  • Los caracteres 18 al 25 son los ocho caracteres restantes del ISAN, los cuales especifican el componente "versión" del mismo.
  • El vigesimosexto carácter es otro carácter de verificación (A-Z).
eidr

string

Es el identificador del Entertainment Identifier Registry (EIDR) asignado a un recurso. Este valor solo se usa para los recursos de episodios y películas, y es opcional en ambos casos. El valor contiene un prefijo estándar del registro EIDR, una barra diagonal, una string hexadecimal de 20 caracteres y un carácter alfanumérico (0-9, A-Z) de verificación.
hfa

string

Código de canción de Harry Fox Agency (HFA) de seis caracteres que se emitió para identificar una composición de forma única. Este valor solo es válido para los activos de composición.
ratings[]

object (Rating)

Es una lista de las calificaciones que recibió un activo. La clasificación debe ser válida según el sistema de clasificación especificado.
broadcaster[]

string

Identifica la cadena o el canal que emitió originalmente un programa o una temporada de un programa. Este campo solo debe incluirse para un activo si la emisora asociada a él es diferente del socio que lo sube a YouTube. Ten en cuenta que un programa puede tener varias cadenas. Por ejemplo, un programa puede cambiar de cadena entre temporadas.
totalEpisodesExpected

integer (uint32 format)

Especifica la cantidad total de episodios de duración completa en la temporada. Este valor solo se usa para los activos de temporada.
contentType

string

Es el tipo de contenido de video que representa el activo. Este campo solo es válido para los recursos de películas y episodios, y es obligatorio para los siguientes tipos de esos recursos:

  • Recursos de episodios vinculados a un programa
  • Activos de películas que aparecen en la categoría Películas de YouTube

Los valores aceptables son:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

Es el método por el que las personas tuvieron la primera oportunidad de ver un recurso de video. Este valor solo se usa para los activos de episodios y películas. Es obligatorio para los siguientes activos y, de lo contrario, es opcional:

  • Recursos de episodios vinculados a un programa
  • Activos de películas que aparecen en la categoría Películas de YouTube

Los valores aceptables son:

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

Fecha

Este recurso identifica una fecha, que se representa como sus partes constituyentes (año, mes y día).

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer (uint32 format)

Año de la fecha en el calendario gregoriano. Se supone que es d.C.
month

integer (uint32 format)

Mes de la fecha. El valor debe ser un número entero entre 1 y 12.
day

integer (uint32 format)

Día de la fecha El valor debe ser un número entero entre 1 y 31. Ten en cuenta que algunas combinaciones de día y mes no son válidas.

Calificación

Este objeto contiene una clasificación de contenido para un activo.

Representación JSON 
{
  "ratingSystem": string,
  "rating": string
}
Campos
ratingSystem

string

Es el sistema de clasificación asociado a la clasificación.

Los valores aceptables son:

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

Es la calificación que recibió el activo.