Todos os vídeos enviados pelo endpoint
videos.insert
de projetos de API não verificados criados após 28 de julho de 2020 serão restritos ao modo de visualização particular. Para remover essa restrição, cada projeto de API precisa passar por uma auditoria para verificar a conformidade com os Termos de Serviço. Consulte o Histórico de revisões da API para mais detalhes.
O recurso video
representa um vídeo do YouTube.
Métodos
A API oferece suporte aos seguintes métodos para recursos videos
:
- getRating (em inglês)
- Recupera as classificações que o usuário autorizado deu a uma lista de vídeos especificados. Faça um teste agora.
- list
- Retorna uma lista de vídeos que correspondem aos parâmetros de solicitação da API. Faça um teste agora.
- inserir
- Envia um vídeo para o YouTube e, opcionalmente, define os metadados dele.
- update
- Atualiza os metadados de um vídeo. Faça um teste agora.
- excluir
- Exclui um vídeo do YouTube. Faça um teste agora.
- taxa
- Adicionar uma classificação "Gostei" ou "Não gostei" a um vídeo ou remover uma classificação de um vídeo. Faça um teste agora.
- reportAbuse
- Denunciar um vídeo por incluir conteúdo abusivo. Faça um teste agora.
Representação de recurso
A estrutura JSON a seguir mostra o formato de um recurso videos
:
{ "kind": "youtube#video", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "tags": [ string ], "categoryId": string, "liveBroadcastContent": string, "defaultLanguage": string, "localized": { "title": string, "description": string }, "defaultAudioLanguage": string }, "contentDetails": { "duration": string, "dimension": string, "definition": string, "caption": string, "licensedContent": boolean, "regionRestriction": { "allowed": [ string ], "blocked": [ string ] }, "contentRating": { "acbRating": string, "agcomRating": string, "anatelRating": string, "bbfcRating": string, "bfvcRating": string, "bmukkRating": string, "catvRating": string, "catvfrRating": string, "cbfcRating": string, "cccRating": string, "cceRating": string, "chfilmRating": string, "chvrsRating": string, "cicfRating": string, "cnaRating": string, "cncRating": string, "csaRating": string, "cscfRating": string, "czfilmRating": string, "djctqRating": string, "djctqRatingReasons": [, string ], "ecbmctRating": string, "eefilmRating": string, "egfilmRating": string, "eirinRating": string, "fcbmRating": string, "fcoRating": string, "fmocRating": string, "fpbRating": string, "fpbRatingReasons": [, string ], "fskRating": string, "grfilmRating": string, "icaaRating": string, "ifcoRating": string, "ilfilmRating": string, "incaaRating": string, "kfcbRating": string, "kijkwijzerRating": string, "kmrbRating": string, "lsfRating": string, "mccaaRating": string, "mccypRating": string, "mcstRating": string, "mdaRating": string, "medietilsynetRating": string, "mekuRating": string, "mibacRating": string, "mocRating": string, "moctwRating": string, "mpaaRating": string, "mpaatRating": string, "mtrcbRating": string, "nbcRating": string, "nbcplRating": string, "nfrcRating": string, "nfvcbRating": string, "nkclvRating": string, "oflcRating": string, "pefilmRating": string, "rcnofRating": string, "resorteviolenciaRating": string, "rtcRating": string, "rteRating": string, "russiaRating": string, "skfilmRating": string, "smaisRating": string, "smsaRating": string, "tvpgRating": string, "ytRating": string }, "projection": string, "hasCustomThumbnail": boolean }, "status": { "uploadStatus": string, "failureReason": string, "rejectionReason": string, "privacyStatus": string, "publishAt": datetime, "license": string, "embeddable": boolean, "publicStatsViewable": boolean, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "player": { "embedHtml": string, "embedHeight": long, "embedWidth": long }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ], "topicCategories": [ string ] }, "recordingDetails": { "recordingDate": datetime }, "fileDetails": { "fileName": string, "fileSize": unsigned long, "fileType": string, "container": string, "videoStreams": [ { "widthPixels": unsigned integer, "heightPixels": unsigned integer, "frameRateFps": double, "aspectRatio": double, "codec": string, "bitrateBps": unsigned long, "rotation": string, "vendor": string } ], "audioStreams": [ { "channelCount": unsigned integer, "codec": string, "bitrateBps": unsigned long, "vendor": string } ], "durationMs": unsigned long, "bitrateBps": unsigned long, "creationTime": string }, "processingDetails": { "processingStatus": string, "processingProgress": { "partsTotal": unsigned long, "partsProcessed": unsigned long, "timeLeftMs": unsigned long }, "processingFailureReason": string, "fileDetailsAvailability": string, "processingIssuesAvailability": string, "tagSuggestionsAvailability": string, "editorSuggestionsAvailability": string, "thumbnailsAvailability": string }, "suggestions": { "processingErrors": [ string ], "processingWarnings": [ string ], "processingHints": [ string ], "tagSuggestions": [ { "tag": string, "categoryRestricts": [ string ] } ], "editorSuggestions": [ string ] }, "liveStreamingDetails": { "actualStartTime": datetime, "actualEndTime": datetime, "scheduledStartTime": datetime, "scheduledEndTime": datetime, "concurrentViewers": unsigned long, "activeLiveChatId": string }, "localizations": { (key): { "title": string, "description": string } } }
Propriedades
A tabela a seguir define as propriedades que aparecem neste recurso:
Propriedades | |
---|---|
kind |
string Identifica o tipo do recurso da API. O valor será youtube#video . |
etag |
etag A ETag deste recurso. |
id |
string O ID que o YouTube usa para identificar exclusivamente o vídeo. |
snippet |
object O objeto snippet contém detalhes básicos sobre o vídeo, como título, descrição e categoria. |
snippet.publishedAt |
datetime A data e a hora em que o vídeo foi publicado. Esse período pode ser diferente do horário em que o vídeo foi enviado. Por exemplo, se um vídeo for enviado como privado e se tornar público mais tarde, essa propriedade especificará o momento em que o vídeo se tornou público. Há alguns casos especiais:
|
snippet.channelId |
string O ID que o YouTube usa para identificar de forma exclusiva o canal em que o vídeo foi enviado. |
snippet.title |
string O título do vídeo. O valor da propriedade tem no máximo 100 caracteres e pode conter todos os caracteres UTF-8 válidos, exceto < e >. Você precisará definir um valor para essa propriedade se chamar o método videos.update e estiver atualizando a parte snippet de um recurso video . |
snippet.description |
string A descrição do vídeo. O valor da propriedade tem um comprimento máximo de 5.000 bytes e pode conter todos os caracteres UTF-8 válidos, exceto < e >. |
snippet.thumbnails |
object Um mapa de imagens em miniatura associadas ao vídeo. Para cada objeto no mapa, a chave é o nome da imagem em miniatura, e o valor é um objeto que contém outras informações sobre a miniatura. |
snippet.thumbnails.(key) |
object As chaves-valor válidas são:
|
snippet.thumbnails.(key).url |
string O URL da imagem. |
snippet.thumbnails.(key).width |
unsigned integer Largura da imagem. |
snippet.thumbnails.(key).height |
unsigned integer A altura da imagem. |
snippet.channelTitle |
string O título do canal a que o vídeo pertence. |
snippet.tags[] |
list Lista de tags de palavras-chave associadas ao vídeo. As tags podem conter espaços. O valor da propriedade pode ter no máximo 500 caracteres. Observe as seguintes regras com relação ao modo como o limite de caracteres é calculado:
|
snippet.categoryId |
string A categoria do vídeo do YouTube associada ao vídeo. Você vai precisar definir um valor para essa propriedade se chamar o método videos.update e estiver atualizando a parte snippet de um recurso video . |
snippet.liveBroadcastContent |
string Indica se o vídeo é uma transmissão ao vivo futura/ativa. Ou será "nenhum" se o vídeo não for uma transmissão ao vivo futura/ativa. Os valores válidos para esta propriedade são:
|
snippet.defaultLanguage |
string O idioma do texto nas propriedades snippet.title e snippet.description do recurso video . |
snippet.localized |
object O objeto snippet.localized contém um título e uma descrição localizados para o vídeo ou o título no idioma padrão para os metadados do vídeo.
localizations para adicionar, atualizar ou excluir títulos localizados. |
snippet.localized.title |
string O título do vídeo localizado. |
snippet.localized.description |
string A descrição do vídeo localizado. |
snippet.defaultAudioLanguage |
string A propriedade default_audio_language especifica o idioma falado na faixa de áudio padrão do vídeo. |
contentDetails |
object O objeto contentDetails contém informações sobre o conteúdo do vídeo, incluindo a duração dele e uma indicação da disponibilidade de legendas. |
contentDetails.duration |
string A duração do vídeo. O valor da propriedade é uma duração ISO 8601. Por exemplo, para um vídeo com pelo menos um minuto e menos de uma hora de duração, a duração está no formato PT#M#S , no qual as letras PT indicam que o valor especifica um período, e as letras M e S se referem à duração em minutos e segundos, respectivamente. Os caracteres # que precedem as letras M e S são números inteiros que especificam o número de minutos (ou segundos) do vídeo. Por exemplo, o valor PT15M33S indica que o vídeo tem 15 minutos e 33 segundos de duração.Se o vídeo tiver pelo menos uma hora, a duração estará no formato PT#H#M#S , em que o # que precede a letra H especifica a duração do vídeo em horas, e todos os outros detalhes são iguais, conforme descrito acima. Se o vídeo tiver pelo menos um dia de duração, as letras P e T serão separadas e o formato do valor será P#DT#H#M#S . Consulte a especificação ISO 8601 para ver todos os detalhes. |
contentDetails.dimension |
string Indica se o vídeo está disponível em 3D ou 2D. |
contentDetails.definition |
string Indica se o vídeo está disponível em alta definição ( HD ) ou apenas em definição padrão.Os valores válidos para essa propriedade são:
|
contentDetails.caption |
string Indica se as legendas estão disponíveis para o vídeo. Os valores válidos para essa propriedade são:
|
contentDetails.licensedContent |
boolean Indica se o vídeo representa conteúdo licenciado, ou seja, que o conteúdo foi enviado a um canal vinculado a um parceiro de conteúdo do YouTube e depois reivindicado por esse parceiro. |
contentDetails.regionRestriction |
object O objeto regionRestriction contém informações sobre os países onde um vídeo é (ou não) visível. O objeto vai conter a propriedade contentDetails.regionRestriction.allowed ou contentDetails.regionRestriction.blocked . |
contentDetails.regionRestriction.allowed[] |
list Uma lista de códigos de região que identificam os países onde o vídeo pode ser assistido. Se esta propriedade estiver presente e um país não estiver listado em seu valor, o vídeo será bloqueado para ser exibido nesse país. Se esta propriedade estiver presente e contiver uma lista vazia, o vídeo será bloqueado em todos os países. |
contentDetails.regionRestriction.blocked[] |
list A lista de códigos regionais que identificam os países em que o vídeo está bloqueado. Se esta propriedade estiver presente e um país não estiver listado em seu valor, o vídeo será visível nesse país. Se esta propriedade estiver presente e contiver uma lista vazia, o vídeo será visível em todos os países. |
contentDetails.contentRating |
object Especifica as classificações que o vídeo recebeu de acordo com vários esquemas. |
contentDetails.contentRating.acbRating |
string A classificação do Australian Classification Board (ACB) ou da Australian Communications and Media Authority (ACMA) de vídeos. As classificações da ACMA são usadas para classificar a programação de televisão infantil. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.agcomRating |
string A classificação do vídeo feita pela Autorità per le Garanzie nelle Comunicazioni (AGCOM) da Itália. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.anatelRating |
string A classificação do vídeo da Anatel (Asociación Nacional de Televisión) para a televisão chilena. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.bbfcRating |
string A classificação do Conselho Britânico de Classificação de Filmes (BBFC, na sigla em inglês) de vídeos. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.bfvcRating |
string A classificação do vídeo feita pelo Conselho de Censores de Filmes e Vídeos da Tailândia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.bmukkRating |
string A classificação do vídeo feita pelo Conselho Austríaco de Classificação de Mídia (Bundesministerium für Unterricht, Kunst und Kultur). Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.catvRating |
string Sistema de classificação para TV canadense - Sistema de classificação de TV canadense A classificação de vídeo da Comissão Canadense de Rádio-Televisão e Telecomunicações (CRTC, na sigla em inglês) para transmissões em inglês no Canadá. Para mais informações, consulte o site do Conselho de Normalização da Transmissão do Canadá. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.catvfrRating |
string A classificação do vídeo pela Comissão Canadense de Rádio-Televisão e Telecomunicações (CRTC, na sigla em inglês) para transmissões em francês do Canadá. Para mais informações, consulte o site do Conselho de Normalização da Transmissão do Canadá. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.cbfcRating |
string A classificação do Conselho Central de Certificação de Filmes (CBFC, na sigla em inglês, Índia) do vídeo. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.cccRating |
string A classificação do vídeo no Consejo de Calificación Cinematográfica (Chile). Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.cceRating |
string A classificação do vídeo da Comissão de Classificação de Espect ́culos de Portugal. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.chfilmRating |
string A classificação do vídeo na Suíça. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.chvrsRating |
string A classificação do sistema de classificação de vídeos domésticos canadenses (CHVRS, na sigla em inglês) do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.cicfRating |
string A classificação do vídeo feita pela Commission de Contrôle des Films (Bélgica). Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.cnaRating |
string A classificação do vídeo feita pela CONSILIUL NATIONAL NATIONAL AL AUDIOVIZUALULUI (CNA) da Romênia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.cncRating |
string Sistema de classificação na França: Commission de ranking cinematographique Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.csaRating |
string A classificação do vídeo feita pelo Conseil supérieur de l?audiovisuel, da França, que classifica o conteúdo de transmissão. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.cscfRating |
string A classificação do vídeo feita pela Comissão de vigilância da classificação de filmes (CSCF, na sigla em inglês) de Luxemburgo. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.czfilmRating |
string A classificação do vídeo na República Tcheca. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.djctqRating |
string A classificação do Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil) do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Motivos que explicam por que o vídeo recebeu a classificação DJCQT (Brasil). |
contentDetails.contentRating.ecbmctRating |
string Sistema de classificação na Turquia – Conselho de avaliação e classificação do Ministério da Cultura e Turismo Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.eefilmRating |
string A classificação do vídeo na Estônia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.egfilmRating |
string A classificação do vídeo no Egito. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.eirinRating |
string A classificação do Eirin (映倫) do vídeo. Eirin é o sistema de classificação japonês. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.fcbmRating |
string A classificação do vídeo feita pelo Conselho de Censura de Filmes da Malásia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.fcoRating |
string A classificação do vídeo feita pelo Departamento de Cinema, Jornal e Artigos de Hong Kong. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.fmocRating |
string Essa propriedade foi descontinuada em 2 de novembro de 2015. Use a propriedade contentDetails.contentRating.cncRating .A classificação do Centre National du cinéma et de l'image animé (Ministério da Cultura da França) do vídeo. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.fpbRating |
string A classificação do vídeo feita pelo Conselho de Filmes e Publicações da África do Sul. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Motivos que explicam por que o vídeo recebeu a classificação FPB (África do Sul). |
contentDetails.contentRating.fskRating |
string A classificação do Freiwillige Selbstkontrolle der Filmwirtschaft (FSK, Alemanha) do vídeo. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.grfilmRating |
string A classificação do vídeo na Grécia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.icaaRating |
string A classificação do Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Espanha) do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.ifcoRating |
string A classificação do Departamento de Classificação de Filmes da Irlanda (IFCO, na sigla em inglês) do vídeo. Consulte o site da IFCO para mais informações. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.ilfilmRating |
string A classificação do vídeo em Israel. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.incaaRating |
string A classificação do INCAA (Instituto Nacional de Cine y Artes Audiovisuales, Argentina) do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.kfcbRating |
string A classificação do vídeo feita pelo Conselho de Classificação de Filmes do Quênia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (Países Baixos). Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.kmrbRating |
string A classificação do Conselho de Classificação de Mídia da Repúblicada Coreia (ว備물의話型號話) do vídeo. O KMRB classifica vídeos na República da Coreia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.lsfRating |
string A classificação do vídeo feita pelo Lembaga Sensor Film da Indonésia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.mccaaRating |
string A classificação do vídeo feita pelo Conselho de Classificação Indicativa de Filmes de Malta. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.mccypRating |
string A classificação do vídeo feita pelo Conselho de Mídia para Crianças e Jovens do Instituto Dinamarquês (Det Danske Filminstitut). Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.mcstRating |
string O sistema de classificação do vídeo para o Vietnã – MCST Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.mdaRating |
string A classificação do vídeo feita pela Autoridade de Desenvolvimento de Mídia (MDA, na sigla em inglês) de Singapura e, especificamente, o Conselho de Censores de Filmes (BFC, na sigla em inglês). Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.medietilsynetRating |
string A classificação do vídeo feita por Medietilsynet, a autoridade de mídia da Noruega. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.mekuRating |
string A classificação do vídeo feita pelo Kansallinen Audiovisualinen Instituutti (Institutti Nacional Audiovisual) da Finlândia. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.mibacRating |
string A classificação do vídeo feita pelo Ministero dei Beni e delle Attività Culturali e del Turismo (Itália). Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.mocRating |
string A classificação do Ministerio de Cultura (Colômbia) do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.moctwRating |
string A classificação do vídeo feita pelo Ministério da Cultura de Taiwan (link em inglês) (Inglês) Os valores válidos para essa propriedade são os seguintes:
|
contentDetails.contentRating.mpaaRating |
string A classificação da Motion Picture Association of America (MPAA) do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.mpaatRating |
string A classificação da Motion Picture Association of America para trailers e prévias de filmes. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.mtrcbRating |
string A classificação do vídeo feita pelo Conselho de Análise e Classificação de Filmes e Televisão (Filipinas). Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.nbcRating |
string A classificação do vídeo segundo o Departamento Nacional de Classificação das Maldivas. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.nfrcRating |
string A classificação do vídeo feita pelo Bulgário National Film Center. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.nfvcbRating |
string A classificação do vídeo feita pelo National Film and Video Censors Board da Nigéria. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.nkclvRating |
string A classificação do vídeo segundo o Centro Nacional de Cinema da Letônia (Nacionãlais Kino). Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.oflcRating |
string A classificação do Office of Film and Literature Classification (OFLC, na Nova Zelândia, na sigla em inglês) de vídeos. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.pefilmRating |
string A classificação do vídeo no Peru. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.resorteviolenciaRating |
string A classificação do vídeo na Venezuela. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.rtcRating |
string A classificação da Diretoria Geral de Rádio, Televisão e Cinematografia (México) do vídeo. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.rteRating |
string A classificação do vídeo feita por Raidió Teilifís Éireann, da Irlanda. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.russiaRating |
string A classificação no Registro Nacional de Filmes da Federação Russa (MKRF, na sigla em russo) do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.skfilmRating |
string A classificação do vídeo na Eslováquia. Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.smaisRating |
string Classificação do vídeo na Islândia. Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.smsaRating |
string A classificação do vídeo feita por Statens medieråd (Conselho Nacional de Mídia da Suécia). Os valores válidos para essa propriedade são:
|
contentDetails.contentRating.tvpgRating |
string É a classificação do vídeo sobre Diretrizes da família para TV (TVPG, na sigla em inglês). Os valores válidos para esta propriedade são:
|
contentDetails.contentRating.ytRating |
string Uma classificação que o YouTube usa para identificar conteúdo com restrição de idade. Os valores válidos para essa propriedade são:
|
contentDetails.projection |
string Especifica o formato de projeção do vídeo. Os valores válidos para esta propriedade são:
|
contentDetails.hasCustomThumbnail |
boolean Indica se o usuário que fez o envio forneceu uma imagem de miniatura personalizada para o vídeo. Esta propriedade só é visível para o usuário que fez o envio do vídeo. |
status |
object O objeto status contém informações sobre os status de envio, processamento e privacidade do vídeo. |
status.uploadStatus |
string Status do vídeo enviado. Os valores válidos para essa propriedade são:
|
status.failureReason |
string Esse valor explica por que um vídeo não foi enviado. Essa propriedade só vai estar presente se a propriedade uploadStatus indicar que o upload falhou.Os valores válidos para essa propriedade são:
|
status.rejectionReason |
string Esse valor explica por que o YouTube rejeitou um vídeo enviado. Essa propriedade só vai estar presente se a propriedade uploadStatus indicar que o upload foi rejeitado.Os valores válidos para essa propriedade são:
|
status.privacyStatus |
string É o status de privacidade do vídeo. Estes são os valores válidos para essa propriedade:
|
status.publishAt |
datetime A data e a hora em que o vídeo está programado para ser publicado. Ela só pode ser definida se o status de privacidade do vídeo for privado. O valor é especificado no formato ISO 8601. Observe os dois pontos adicionais a seguir sobre o comportamento dessa propriedade:
|
status.license |
string A licença do vídeo. Os valores válidos para essa propriedade são:
|
status.embeddable |
boolean Esse valor indica se o vídeo pode ser incorporado a outro site. |
status.publicStatsViewable |
boolean Esse valor indica se as estatísticas estendidas do vídeo na página de exibição do vídeo são visíveis publicamente. Por padrão, essas estatísticas são visíveis, e estatísticas como a contagem de visualizações e as notas de um vídeo ainda ficarão visíveis publicamente, mesmo que o valor dessa propriedade esteja definido como false . |
status.madeForKids |
boolean Esse valor indica se o vídeo está designado como feito para crianças e contém o status atual "conteúdo para crianças". Por exemplo, o status pode ser determinado com base no valor da propriedade selfDeclaredMadeForKids . Consulte a
Central de Ajuda do YouTube para mais
informações sobre como definir o público dos seus canais, vídeos ou transmissões.
|
status.selfDeclaredMadeForKids |
boolean Em uma solicitação videos.insert ou videos.update , essa propriedade permite que o proprietário do canal designe o vídeo como direcionado a crianças. Em uma solicitação videos.list , o valor da propriedade só será retornado se o proprietário do canal autorizar a solicitação da API. |
statistics |
object O objeto statistics contém estatísticas sobre o vídeo. |
statistics.viewCount |
unsigned long O número de vezes que o vídeo foi assistido. |
statistics.likeCount |
unsigned long O número de usuários que indicaram que gostaram do vídeo. |
statistics.dislikeCount |
unsigned long Observação:a propriedade
statistics.dislikeCount passou a ser particular em
13 de dezembro de 2021. Isso significa que a propriedade será incluída em uma resposta da API somente se a solicitação de API tiver sido autenticada pelo proprietário do vídeo. Consulte o
histórico de revisões para mais informações.O número de usuários que indicaram que não gostaram do vídeo. |
statistics.favoriteCount |
unsigned long Observação:essa propriedade foi descontinuada. A descontinuação está em vigor desde 28 de agosto de 2015. Agora, o valor da propriedade vai ser sempre definido como 0 . |
statistics.commentCount |
unsigned long O número de comentários do vídeo. |
player |
object O objeto player contém informações usadas para reproduzir o vídeo em um player incorporado. |
player.embedHtml |
string Uma tag <iframe> que incorpora um player que reproduz o vídeo.
|
player.embedHeight |
long A altura do player incorporado retornada na propriedade player.embedHtml . Essa propriedade só vai ser retornada se a solicitação especificar um valor para os parâmetros maxHeight e/ou maxWidth e a proporção do vídeo for conhecida. |
player.embedWidth |
long É a largura do player incorporado retornado na propriedade player.embedHtml . Essa propriedade só vai ser retornada se a solicitação especificar um valor para os parâmetros maxHeight e/ou maxWidth e a proporção do vídeo for conhecida. |
topicDetails |
object O objeto topicDetails encapsula informações sobre temas associados ao vídeo.Importante:consulte as definições das propriedades topicDetails.relevantTopicIds[] e topicDetails.topicIds[] , bem como o histórico de revisões, para mais detalhes sobre as próximas mudanças relacionadas aos IDs de tópicos. |
topicDetails.topicIds[] |
list Importante:essa propriedade foi descontinuada em 10 de novembro de 2016. A API não retorna mais valores para essa propriedade, e todos os temas associados a um vídeo agora são retornados pelo valor da propriedade topicDetails.relevantTopicIds[] . |
topicDetails.relevantTopicIds[] |
list Uma lista de IDs de temas relevantes para o vídeo. Essa propriedade foi descontinuada em 10 de novembro de 2016. Ele terá suporte até 10 de novembro de 2017. Importante:devido à descontinuação do Freebase e da API Freebase, os IDs de tópico começaram a funcionar de forma diferente a partir de 27 de fevereiro de 2017. Nessa época, o YouTube começou a retornar um pequeno conjunto de IDs de temas selecionados. |
topicDetails.topicCategories[] |
list Uma lista de URLs da Wikipédia com uma descrição de alto nível do conteúdo do vídeo. |
recordingDetails |
object O objeto recordingDetails encapsula informações sobre o local, a data e o endereço em que o vídeo foi gravado. |
recordingDetails.locationDescription |
string Essa propriedade foi descontinuada em 1o de junho de 2017. Para mais detalhes, consulte o aviso de descontinuação. A descrição em texto do local em que o vídeo foi gravado. |
recordingDetails.location |
object As informações de geolocalização associadas ao vídeo. Os valores da propriedade filha identificam o local que o proprietário do vídeo deseja associar ao vídeo. O valor é editável, pesquisável em vídeos públicos, e pode ser exibido aos usuários no caso de vídeos públicos. |
recordingDetails.location.latitude |
double Essa propriedade foi descontinuada em 1o de junho de 2017. Para mais detalhes, consulte o aviso de descontinuação. Latitude em graus. |
recordingDetails.location.longitude |
double Essa propriedade foi descontinuada em 1o de junho de 2017. Para mais detalhes, consulte o aviso de descontinuação. Longitude em graus. |
recordingDetails.location.altitude |
double Essa propriedade foi descontinuada em 9 de julho de 2018. Para mais detalhes, consulte o aviso de descontinuação. Altitude acima do elipsoide de referência, em metros. |
recordingDetails.recordingDate |
datetime A data e a hora em que o vídeo foi gravado. O valor é especificado no formato ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ). |
fileDetails |
object O objeto fileDetails encapsula informações sobre o arquivo de vídeo enviado para o YouTube, incluindo a resolução, a duração, os codecs de áudio e vídeo, as taxas de bits de stream e muito mais. Esses dados só podem ser recuperados pelo proprietário do vídeo.O objeto fileDetails só vai ser retornado se a propriedade processingDetails.fileAvailability tiver um valor de available . |
fileDetails.fileName |
string O nome do arquivo enviado. Este campo estará presente se um arquivo de vídeo ou outro tipo de arquivo tiver sido enviado. |
fileDetails.fileSize |
unsigned long O tamanho do arquivo enviado por upload em bytes. Este campo estará presente se um arquivo de vídeo ou outro tipo de arquivo tiver sido enviado. |
fileDetails.fileType |
string O tipo do arquivo enviado, conforme detectado pelo mecanismo de processamento de vídeo do YouTube. No momento, o YouTube só processa arquivos de vídeo, mas esse campo estará presente se um arquivo de vídeo ou outro tipo de arquivo tiver sido enviado. Os valores válidos para essa propriedade são:
|
fileDetails.container |
string O formato do contêiner do arquivo de vídeo enviado. |
fileDetails.videoStreams[] |
list A lista de streams de vídeo contidos no arquivo de vídeo enviado. Cada item da lista contém metadados detalhadas sobre um stream de vídeo. |
fileDetails.videoStreams[].widthPixels |
unsigned integer A largura do conteúdo do vídeo codificada em pixels. Você pode calcular a proporção de codificação do vídeo como width_pixels / height_pixels . |
fileDetails.videoStreams[].heightPixels |
unsigned integer A altura do conteúdo do vídeo codificada em pixels. |
fileDetails.videoStreams[].frameRateFps |
double O frame rate do stream de vídeo, em quadros por segundo. |
fileDetails.videoStreams[].aspectRatio |
double A proporção de exibição do conteúdo do vídeo, que especifica a proporção em que o vídeo será exibido. |
fileDetails.videoStreams[].codec |
string O codec de vídeo usado pelo stream. |
fileDetails.videoStreams[].bitrateBps |
unsigned long A taxa de bits do stream de vídeo, em bits por segundo. |
fileDetails.videoStreams[].rotation |
string O valor que o YouTube precisa para alternar o conteúdo original de origem para exibir o vídeo corretamente. Os valores válidos para essa propriedade são:
|
fileDetails.videoStreams[].vendor |
string Um valor que identifica exclusivamente um fornecedor de vídeo. Normalmente, o valor é um código de fornecedor de quatro letras. |
fileDetails.audioStreams[] |
list A lista de streams de áudio contidos no arquivo de vídeo enviado. Cada item da lista contém metadados detalhados sobre um stream de áudio. |
fileDetails.audioStreams[].channelCount |
unsigned integer O número de canais de áudio que o stream contém. |
fileDetails.audioStreams[].codec |
string O codec de áudio que o stream usa. |
fileDetails.audioStreams[].bitrateBps |
unsigned long A taxa de bits do stream de áudio, em bits por segundo. |
fileDetails.audioStreams[].vendor |
string Um valor que identifica exclusivamente um fornecedor de vídeo. Normalmente, o valor é um código de fornecedor de quatro letras. |
fileDetails.durationMs |
unsigned long A duração do vídeo enviado em milissegundos. |
fileDetails.bitrateBps |
unsigned long A taxa de bits combinada (vídeo e áudio) do arquivo de vídeo enviado em bits por segundo. |
fileDetails.creationTime |
string A data e a hora em que o arquivo de vídeo enviado foi criado. O valor é especificado no formato ISO 8601. No momento, os seguintes formatos ISO 8601 são suportados:
|
processingDetails |
object O objeto processingDetails encapsula informações sobre o progresso do YouTube no processamento do arquivo de vídeo enviado. As propriedades do objeto identificam o status de processamento atual e uma estimativa do tempo restante até que o YouTube termine o processamento do vídeo. Esta parte também indica se os diferentes tipos de dados ou de conteúdo, como detalhes do arquivo ou imagens em miniatura, estão disponíveis para o vídeo.O objeto processingProgress foi criado para ser pesquisado para que o vídeo enviado possa acompanhar o progresso que o YouTube teve no processamento do arquivo de vídeo enviado. Esses dados só podem ser recuperados pelo proprietário do vídeo. |
processingDetails.processingStatus |
string Status do processamento do vídeo. Esse valor indica se o YouTube conseguiu processar o vídeo ou se o vídeo ainda está sendo processado. Os valores válidos para esta propriedade são:
|
processingDetails.processingProgress |
object O objeto processingProgress contém informações sobre o progresso que o YouTube fez no processamento do vídeo. Os valores só são relevantes quando o status de processamento do vídeo é processing . |
processingDetails.processingProgress.partsTotal |
unsigned long Estimativa do número total de partes que precisam ser processadas no vídeo. O número pode ser atualizado com estimativas mais precisas enquanto o YouTube processa o vídeo. |
processingDetails.processingProgress.partsProcessed |
unsigned long O número de partes do vídeo que já foram processadas pelo YouTube. Você pode estimar a porcentagem do vídeo que já foi processada pelo YouTube calculando: 100 * parts_processed / parts_total Como o número estimado de partes pode aumentar sem um aumento correspondente no número de partes que já foram processadas, é possível que o progresso calculado diminua periodicamente enquanto o YouTube processa um vídeo. |
processingDetails.processingProgress.timeLeftMs |
unsigned long Uma estimativa do tempo necessário, em milissegundos, para o YouTube terminar de processar o vídeo. |
processingDetails.processingFailureReason |
string O motivo pelo qual o YouTube não conseguiu processar o vídeo. Essa propriedade só vai ter um valor se o valor da propriedade processingStatus for failed .Os valores válidos para essa propriedade são:
|
processingDetails.fileDetailsAvailability |
string Esse valor indica se os detalhes do arquivo estão disponíveis para o vídeo enviado. Você pode recuperar os detalhes de um arquivo de vídeo solicitando a parte fileDetails na sua solicitação videos.list() . |
processingDetails.processingIssuesAvailability |
string Esse valor indica se o mecanismo de processamento de vídeo gerou sugestões que podem melhorar a capacidade do YouTube de processar o vídeo, avisos que explicam problemas de processamento do vídeo ou erros que causam problemas de processamento do vídeo. Você pode extrair essas sugestões solicitando a parte suggestions na sua solicitação videos.list() . |
processingDetails.tagSuggestionsAvailability |
string Esse valor indica se as sugestões de palavra-chave (tag) estão disponíveis para o vídeo. As tags podem ser adicionadas aos metadados de um vídeo para facilitar que outros usuários encontrem-no. Você pode extrair essas sugestões solicitando a parte suggestions na sua solicitação videos.list() . |
processingDetails.editorSuggestionsAvailability |
string Esse valor indica se as sugestões de edição de vídeo, que podem melhorar a qualidade do vídeo ou a experiência de reprodução, estão disponíveis para o vídeo. Você pode extrair essas sugestões solicitando a parte suggestions na sua solicitação videos.list() . |
processingDetails.thumbnailsAvailability |
string Esse valor indica se imagens em miniatura foram geradas para o vídeo. |
suggestions |
object O objeto suggestions encapsula sugestões que identificam oportunidades para melhorar a qualidade ou os metadados do vídeo enviado. Esses dados só podem ser recuperados pelo proprietário do vídeo. O objeto suggestions só vai ser retornado se a propriedade processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability tiver o valor available . |
suggestions.processingErrors[] |
list Uma lista de erros que vão impedir que o YouTube processe o vídeo enviado. Esses erros indicam que, no final, independentemente do status de processamento atual do vídeo, esse status certamente será failed .Os valores válidos para essa propriedade são:
|
suggestions.processingWarnings[] |
list Uma lista de motivos pelos quais o YouTube pode ter dificuldade para transcodificar o vídeo enviado ou que pode resultar em uma transcodificação incorreta. Esses avisos são gerados antes de o YouTube realmente processar o arquivo de vídeo enviado. Além disso, eles identificam problemas que não indicam necessariamente uma falha no processamento do vídeo, mas que ainda podem causar problemas como problemas de sincronização, artefatos de vídeo ou uma faixa de áudio ausente. Os valores válidos para esta propriedade são:
|
suggestions.processingHints[] |
list Uma lista de sugestões que podem melhorar a capacidade do YouTube de processar o vídeo. Os valores válidos para essa propriedade são:
|
suggestions.tagSuggestions[] |
list Uma lista de tags de palavras-chave que podem ser adicionadas aos metadados do vídeo para aumentar a probabilidade de os usuários localizarem seu vídeo ao pesquisar ou navegar no YouTube. |
suggestions.tagSuggestions[].tag |
string Tag de palavra-chave sugerida para o vídeo. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Um conjunto de categorias de vídeo para as quais a tag é relevante. Você pode usar essas informações para exibir sugestões de tags apropriadas com base na categoria de vídeo que o usuário que faz upload associa ao vídeo. Por padrão, sugestões de tags são relevantes para todas as categorias se não houver restrições definidas para a palavra-chave. |
suggestions.editorSuggestions[] |
list Uma lista de operações de edição de vídeo que podem melhorar a qualidade ou a experiência de reprodução do vídeo enviado. Os valores válidos para essa propriedade são:
|
liveStreamingDetails |
object O objeto liveStreamingDetails contém metadados sobre uma transmissão de vídeo ao vivo. O objeto só estará presente em um recurso video se o vídeo for uma transmissão ao vivo futura, concluída ou ao vivo. |
liveStreamingDetails.actualStartTime |
datetime A hora em que a transmissão começou. O valor é especificado no formato ISO 8601. Este valor não estará disponível até o início da transmissão. |
liveStreamingDetails.actualEndTime |
datetime A hora em que a transmissão realmente terminou. O valor é especificado no formato ISO 8601. Este valor não estará disponível até que a transmissão termine. |
liveStreamingDetails.scheduledStartTime |
datetime O horário em que a transmissão está programada para começar. O valor é especificado no formato ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetime O horário em que a transmissão está programada para terminar. O valor é especificado no formato ISO 8601. Se o valor estiver vazio ou a propriedade não estiver presente, a transmissão será programada para continuar indefinidamente. |
liveStreamingDetails.concurrentViewers |
unsigned long O número de espectadores que estão assistindo à transmissão no momento. A propriedade e o valor dela estarão presentes se a transmissão tiver espectadores atuais e o proprietário não tiver ocultado a contagem de visualizações do vídeo. Observe que o YouTube para de rastrear o número de espectadores simultâneos em uma transmissão quando ela termina. Portanto, essa propriedade não identificaria o número de espectadores que assistem a um vídeo arquivado de uma transmissão ao vivo que já terminou. A contagem de espectadores simultâneos que a API YouTube Data retorna pode ser diferente das contagens de espectadores simultâneos processadas e sem spam disponíveis no YouTube Analytics. Saiba mais sobre as métricas de transmissões ao vivo na
Central de Ajuda do YouTube.
|
liveStreamingDetails.activeLiveChatId |
string ID do chat ao vivo ativo anexado ao vídeo. Este campo só será preenchido se o vídeo for uma transmissão ao vivo no momento com chat ao vivo. Quando a transmissão termina, esse campo é removido e o chat ao vivo é fechado. Para transmissões persistentes, o ID do chat ao vivo não será mais vinculado a este vídeo, e sim ao novo vídeo que está sendo exibido na página persistente. |
localizations |
object O objeto localizations contém traduções dos metadados do vídeo. |
localizations.(key) |
object O idioma do texto localizado associado à chave-valor. O valor é uma string que contém um código de idioma BCP-47. |
localizations.(key).title |
string O título do vídeo localizado. |
localizations.(key).description |
string A descrição do vídeo localizado. |