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 ( |
Campos | |
---|---|
customId |
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 ( |
title |
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:
|
notes |
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 |
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[] |
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,
|
isrc |
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 |
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[] |
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 |
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 |
O UPC (Código universal de produto) associado ao recurso. |
album |
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 |
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 |
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 |
Categoria deste recurso. |
copyrightDate |
A data em que os direitos autorais deste recurso foram estabelecidos. * |
startYear |
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 |
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 |
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 |
keyword[] |
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 |
Código do TMS (Tribune Media Systems) para o recurso. |
showCustomId |
O |
showTitle |
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 |
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 |
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[] |
Uma lista que identifica os escritores associados ao recurso. É possível especificar até 50 escritores para um recurso. |
actor[] |
Uma lista que identifica atores associados ao recurso. É possível especificar até 50 atores para um recurso. |
director[] |
Uma lista que identifica os diretores associados ao recurso. É possível especificar até 50 diretores para um recurso. |
producer[] |
Uma lista que identifica os produtores do recurso. É possível especificar até 50 produtores para um recurso. |
releaseDate |
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:
|
spokenLanguage |
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[] |
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 |
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:
|
eidr |
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 |
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[] |
Uma lista de classificações recebidas por um recurso. A classificação precisa ser válida de acordo com o sistema especificado. |
broadcaster[] |
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 |
Especifica o número total de episódios completos na temporada. Esse valor é usado somente para recursos de temporada. |
contentType |
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:
|
originalReleaseMedium |
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:
|
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 |
O ano da data no calendário gregoriano. Presumido como d.C. |
month |
O mês da data. O valor precisa ser um número inteiro entre |
day |
O dia da data. O valor precisa ser um número inteiro entre |
Classificação
Este objeto contém uma classificação do conteúdo para um recurso.
Representação JSON |
---|
{ "ratingSystem": string, "rating": string } |
Campos | |
---|---|
ratingSystem |
O sistema associado à classificação. |
rating |
A classificação que o recurso recebeu. |