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 código 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, hifens (-), sublinhados (_), pontos (.), "a" símbolos (@) ou barras (/).

title

string

O título ou o 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 VLOOKUP

notes

string

Informações adicionais que não mapeiam 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

Esse 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 conjuntos 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 VLOOKUP

isrc

string

O Código de gravação padrão internacional (ISRC, na sigla em inglês) 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 (identificador de lançamento global) de um vídeo de música ou gravação de som. O valor deste campo precisa conter exatamente 18 caracteres alfanuméricos.

artist[]

string

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

label

string

A gravadora que lançou um recurso de gravação de som. Esse campo só é válido 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 só é válido 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 1537 bytes. Seus esforços seriam inúteis.

iswc

string

O ISWC (International Standard Musical Work Code) 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 ao ar. Esse valor é obrigatório e usado apenas para recursos de programa.

endYear

integer (uint32 format)

O ano passado em que um programa de televisão foi ao ar. Esse valor é usado apenas para recursos de programa, o que é opcional. Não especifique um valor se novos episódios de programas ainda estiverem sendo criados.

episodesAreUntitled

boolean

Esse valor indica que os episódios associados a um recurso de programa específico ou a um recurso de temporada específico não têm título. Um programa (ou temporada) sem título tem episódios identificados pelo número ou pela data do episódio. Se ele for definido como true, o YouTube 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 recursos de programas.

tmsId

string

Código do TMS (Tribune Media Systems) para o recurso.

showCustomId

string

O customId do recurso de programa a que um recurso de temporada ou episódio está associado. Ela é obrigatória para os recursos de temporadas e episódios que aparecem na categoria Programas no YouTube e não é válida para outros tipos de recursos. Este campo tem um comprimento máximo de 64 bytes e pode conter caracteres alfanuméricos, hifens (-), sublinhados (_), pontos (.), "a" símbolos (@) ou barras (/).

showTitle

string

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

seasonNumber

string

O número da temporada que identifica o recurso da temporada ou o número da temporada associado ao recurso do 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ódio vinculados a recursos de programa. Ele pode ter no máximo 5 bytes.

writer[]

string

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

actor[]

string

Uma lista que identifica 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, este valor especifica a primeira data em que a temporada foi ao ar. 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, mas é opcional em outros 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 somente para recursos de episódio e filme 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 incorporadas 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 somente para recursos de episódio e filme e não é válido para outros tipos de recursos.

isan

string

O número audiovisual padrão internacional (ISAN, na sigla em inglês) do recurso. Esse valor é usado somente para recursos de episódio e filme 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 17o 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 Registro Identificador de Entretenimento (EIDR, na sigla em inglês) atribuído a um recurso. Esse valor é usado somente para recursos de episódio e filme 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 só é válido para recursos de composição.

ratings[]

object (Rating)

Uma lista de classificações recebidas por um recurso. A classificação precisa ser válida de acordo com o sistema especificado.

broadcaster[]

string

Identifica a rede ou o canal que transmitiu originalmente um programa ou uma temporada de um programa. Esse campo só deverá ser incluído para um recurso se a emissora associada a ele for diferente do parceiro que está enviando o recurso ao YouTube. Observe que um programa pode ter várias emissoras. por exemplo, um programa pode mudar de canal entre as temporadas.

totalEpisodesExpected

integer (uint32 format)

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

contentType

string

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

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

originalReleaseMedium

string

O método usado pela primeira vez para ver um recurso de vídeo. Esse valor é usado apenas para recursos de episódio e filme. Ele é obrigatório para os recursos listados abaixo, mas é opcional em outros casos:

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

Data

Esse recurso identifica uma data, que é representada como as 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/mês não são válidas.

Classificação

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

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

string

O sistema associado à classificação.

rating

string

A classificação que o recurso recebeu.