Metadata

Os metadados de um recurso. Alguns campos de metadados são válidos apenas para determinados tipos de recursos.

Representação 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

Um valor exclusivo que você, o provedor de metadados, usa para identificar um recurso. O valor pode ser um ID exclusivo criado para o recurso ou um identificador padrão, como um ISRC. O valor tem um comprimento máximo de 64 bytes e pode conter caracteres alfanuméricos, hífens (-), sublinhados (_), pontos (.), arrobas (@) ou barras (/).
title

string

O título ou nome do recurso. O valor tem um comprimento máximo de 255 bytes. Esse valor é obrigatório para os recursos listados abaixo e opcional para todos os outros:

  • Mostrar recursos
  • Recursos de episódio vinculados a um programa
  • Recursos de filmes que aparecem na categoria Filmes do YouTube
  • Gravações de som incluídas no programa AudioSwap
notes

string

Informações adicionais que não são mapeadas diretamente para um dos outros campos de metadados. Este campo tem comprimento máximo de 255 bytes.
description

string

Uma descrição do recurso. A descrição pode ser exibida no YouTube ou no CMS. Este campo tem um comprimento máximo de 5.000 bytes.
genre[]

string

Este campo especifica um gênero que pode ser usado para categorizar um recurso. Os recursos podem ser categorizados em mais de um gênero, e o YouTube usa diferentes grupos de gêneros para categorizar diferentes tipos de recursos. Por exemplo, Soaps pode ser um gênero válido para um programa, mas não para um filme ou uma gravação de som.

  • Mostrar recursos
  • Recursos de filmes que aparecem na categoria Filmes do YouTube
  • Gravações de som incluídas no programa AudioSwap
isrc

string

O ISRC (International Standard Recording Code) de um recurso de vídeo de música ou gravação de som. O valor desse campo precisa conter exatamente 12 caracteres alfanuméricos.
grid

string

O GRID (Global Release Identifier) de um videoclipe ou uma gravação de som. O valor deste campo precisa conter exatamente 18 caracteres alfanuméricos.
artist[]

string

O artista associado a um recurso de vídeo de música ou gravação de som. Esse campo é válido apenas para recursos de vídeo de música e gravação de som. É obrigatório para gravações de som incluídas no programa AudioSwap.
label

string

A gravadora que lançou um recurso de gravação de som. Esse campo é válido apenas para recursos de gravação de som e tem um comprimento máximo de 255 bytes.
upc

string

O UPC (Código universal de produto) associado ao recurso.
album

string

O álbum em que um recurso de gravação de som está incluído. Esse campo é válido apenas para recursos de gravação de som e tem um comprimento máximo de 255 bytes.
infoUrl

string

Um URL oficial associado ao recurso. Este campo tem um comprimento máximo de 1.536 bytes, Não envie um URL de 1.537 bytes. Seus esforços seriam inúteis.
iswc

string

O ISWC (Código Padrão Internacional de Obra Musical) de um recurso de composição. O valor do campo precisa conter exatamente 11 caracteres no formato de uma letra T seguida de 10 dígitos.
category

string

Categoria deste recurso.
copyrightDate

object (Date)

A data em que os direitos autorais deste recurso foram estabelecidos. *
startYear

integer (uint32 format)

O primeiro ano em que um programa de televisão foi exibido. Esse valor é necessário e usado apenas para mostrar recursos.
endYear

integer (uint32 format)

O último ano em que um programa de TV foi exibido. Esse valor é usado apenas para mostrar recursos, e é opcional. Não especifique um valor se novos episódios do programa ainda estiverem sendo criados.
episodesAreUntitled

boolean

Esse valor indica que os episódios associados a um recurso de programa ou temporada específica não têm título. Uma série (ou temporada) sem título tem episódios identificados pelo número ou data. Se esse campo for definido como true, o YouTube vai otimizar o título exibido para os episódios associados.
keyword[]

string

Uma lista de até 100 palavras-chave associadas a um recurso de programa. Esse campo é obrigatório e usado apenas para mostrar recursos.
tmsId

string

ID do TMS (Tribune Media Systems) do recurso.
showCustomId

string

O customId do recurso de programa a que um recurso de temporada ou episódio está associado. É obrigatório para recursos de temporada e episódio que aparecem na categoria Programas do YouTube e não é válido para outros tipos de recursos. Esse campo tem um comprimento máximo de 64 bytes e pode conter caracteres alfanuméricos, hifens (-), sublinhados (_), pontos (.), arrobas (@) ou barras (/).
showTitle

string

O nome do programa ao qual um recurso de episódio está associado. Observação:essa tag é usada e válida apenas para episódios que não estão associados a recursos de programas. Ela permite que esses recursos ainda mostrem o título do programa na seção de metadados do recurso no CMS. Este campo tem um comprimento máximo de 120 bytes.
seasonNumber

string

O número da temporada que identifica um recurso de temporada ou o número da temporada associado a um recurso de episódio. Este campo tem um comprimento máximo de 5 bytes.
episodeNumber

string

O número do episódio associado a um recurso de episódio. Esse campo é obrigatório e usado apenas para recursos de episódios vinculados a recursos de programas. Tem tamanho máximo de 5 bytes.
writer[]

string

Uma lista que identifica os escritores associados ao recurso. É possível especificar até 50 gravadores para um recurso.
actor[]

string

Uma lista que identifica os atores associados ao recurso. É possível especificar até 50 atores para um recurso.
director[]

string

Uma lista que identifica os diretores associados ao recurso. É possível especificar até 50 diretores para um recurso.
producer[]

string

Uma lista que identifica os produtores do recurso. É possível especificar até 50 produtores para um recurso.
releaseDate

object (Date)

A data em que um recurso foi lançado publicamente. Para recursos de temporada, esse valor especifica a primeira data de exibição da temporada. Datas anteriores ao ano de 1902 não são compatíveis. Esse valor é válido para recursos de episódio, temporada, filme, vídeo de música e gravação de som. Ele é obrigatório para os recursos listados abaixo e opcional nos demais casos:

  • Recursos de episódio vinculados a um programa
  • Recursos de filmes que aparecem na categoria Filmes do YouTube
spokenLanguage

string

O idioma principal falado no vídeo. O valor pode ser qualquer código de idioma de duas letras do ISO 639-1. Esse valor é usado apenas para recursos de episódios e filmes e não é válido para outros tipos de recursos.
subtitledLanguage[]

string

Uma lista de idiomas para os quais o vídeo tem uma faixa de legenda separada ou legendas fixas que fazem parte do vídeo. Cada valor na lista precisa ser um código de idioma de duas letras do ISO 639-1. Esse valor é usado apenas para recursos de episódios e filmes e não é válido para outros tipos de recursos.
isan

string

O ISAN (Número Padrão Internacional de Audiovisual) do recurso. Esse valor é usado apenas para recursos de episódios e filmes e é opcional em ambos os casos. Este valor contém 26 caracteres, que inclui os 24 caracteres hexadecimais do ISAN e os dois caracteres de verificação, no seguinte formato:

  • Os primeiros 16 caracteres no valor da tag contêm caracteres hexadecimais que especificam os componentes "raiz" e "episódio" do ISAN.
  • O 17º caractere é um caractere de verificação (uma letra de A a Z).
  • Os caracteres de 18 a 25 são os oito caracteres restantes do ISAN, que especificam o componente "versão" do ISAN.
  • O 26º caractere é outro caractere de verificação (A -Z).
eidr

string

O ID do Registro Identificador de Entretenimento (EIDR, na sigla em inglês) atribuído a um recurso. Esse valor é usado apenas para recursos de episódios e filmes e é opcional em ambos os casos. O valor contém um prefixo padrão do registro EIDR, seguido de uma barra inclinada, uma sequência hexadecimal de 20 caracteres e um caractere verificador alfanumérico (0-9A-Z).
hfa

string

O código musical de seis caracteres da Harry Fox Agency (HFA) emitido para identificar uma composição de forma exclusiva. Esse valor é válido apenas para recursos de composição.
ratings[]

object (Rating)

Uma lista de classificações que um recurso recebeu. A classificação precisa ser válida de acordo com o sistema de classificação especificado.
broadcaster[]

string

Identifica a rede ou o canal que transmitiu originalmente um programa ou uma temporada de um programa. Esse campo só deve ser incluído para um recurso se a emissora associada a ele for diferente do parceiro que está fazendo o upload para o YouTube. Uma série pode ter várias emissoras. Por exemplo, ela pode mudar de rede entre as temporadas.
totalEpisodesExpected

integer (uint32 format)

Especifica o número total de episódios completos na temporada. Esse valor é usado apenas para recursos de temporada.
contentType

string

O tipo de conteúdo de vídeo que o recurso representa. Esse campo é válido apenas para recursos de filme e episódio e é obrigatório para os seguintes tipos de recursos:

  • Recursos de episódio vinculados a um programa
  • Recursos de filmes que aparecem na categoria Filmes do YouTube

Os valores aceitáveis são:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

O método pelo qual as pessoas tiveram a oportunidade de assistir um recurso de vídeo pela primeira vez. Esse valor é usado apenas para recursos de episódios e filmes. Ele é obrigatório para os seguintes recursos e opcional para os demais:

  • Recursos de episódio vinculados a um programa
  • Recursos de filmes que aparecem na categoria Filmes do YouTube

Os valores aceitáveis são:

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

Data

Esse recurso identifica uma data, que é representada como partes constituintes (ano, mês, dia).

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer (uint32 format)

O ano da data no calendário gregoriano. Presumido como d.C.
month

integer (uint32 format)

O mês da data. O valor precisa ser um número inteiro entre 1 e 12.
day

integer (uint32 format)

O dia da data. O valor precisa ser um número inteiro entre 1 e 31. Algumas combinações de dia e mês não são válidas.

Classificação

Esse objeto contém uma classificação do conteúdo para um recurso.

Representação JSON 
{
  "ratingSystem": string,
  "rating": string
}
Campos
ratingSystem

string

O sistema de classificação associado à classificação.

Os valores aceitáveis são:

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

string

A classificação que o recurso recebeu.