Esta página lista as mudanças na API YouTube Data (v3) e as atualizações da documentação.
16 de novembro de 2026
A partir de 16 de novembro de 2026, o YouTube vai incluir covisualizações (várias pessoas assistindo juntas em uma tela de TV) nas contagens de visualizações públicas em todos os formatos de vídeo: vídeos longos, transmissões ao vivo e Shorts. As contagens de visualizações simultâneas para transmissões ao vivo também incluem covisualizadores.
Os ganhos dos criadores, a receita de publicidade e a qualificação para o Programa de Parcerias do YouTube não são afetados, e as visualizações engajadas não incluem a covisualização. Para saber mais, consulte Como funciona o desempenho do conteúdo no YouTube.
Atualizações da documentação da API: atualizamos as descrições do campo
viewCountna documentação de referência dechannels,videosevideos.batchGetStatse o campoliveStreamingDetails.concurrentViewersna documentação de referência devideos.Adicionamos suporte ao recurso
posts, que representa um post do YouTube. Durante a fase piloto, o recurso e os métodos dele estão disponíveis apenas para parceiros de lançamento selecionados (projetos na nuvem aprovados do Google Cloud), com acesso público mais amplo à API planejado para disponibilidade geral em 2027. Os projetos do Google Cloud aprovados no piloto também podem usar comentários em postagens.A propriedade
paidProductPlacementDetails.hasPaidProductPlacementnão tem maisfalsecomo padrão. Se você não especificar um valor para a propriedade em uma solicitaçãovideos.insertouvideos.update, o vídeo não será declarado como livre de inserção paga de produto. Para declarar que um vídeo não contém inserção paga de produto, defina explicitamente a propriedade comofalse:"paidProductPlacementDetails": { "hasPaidProductPlacement": false }
3 de novembro de 2026
Esta atualização contém as seguintes alterações:
- O método
thumbnails.setagora permite o upload de miniaturas personalizadas para Shorts do YouTube após a conclusão do processamento do vídeo. - A definição do recurso
thumbnailsfoi atualizada para incluir a propriedadeshortsAspectRatiopara miniaturas personalizadas do YouTube Shorts.
2 de novembro de 2026
Os vídeos enviados pelo método
videos.insert de
projetos de API não verificados não estão mais restritos ao modo de visualização privada. Essa
mudança reverte a política anunciada em
28 de julho de 2020, que restringia os vídeos enviados
de projetos de API não verificados criados após essa data ao modo de leitura
até que o projeto concluísse uma auditoria.
Se você não especificar um valor para a propriedade
status.privacyStatus
em uma solicitação videos.insert, o status de privacidade do vídeo enviado
será definido como public por padrão. Alguns envios podem ser definidos como private por padrão, dependendo das
configurações da conta do criador, conforme explicado na
Central de Ajuda do YouTube.
15 de outubro de 2026
O método videos.list foi esclarecido para
observar que as propriedades status.selfDeclaredMadeForKids e status.madeForKids
só são atualizadas se especificadas na solicitação e não são substituídas
se omitidas.
30 de setembro de 2026
A definição do recurso comments
foi atualizada para incluir a nova propriedade snippet.imageUrl, que fornece
o URL de uma imagem ou GIF animado anexado a um comentário.
Esse recurso vai estar disponível para todos os usuários em novembro de 2026.
14 de setembro de 2026
Esta atualização contém as seguintes alterações:
- A descrição do método
thumbnails.setfoi atualizada para indicar que o tamanho máximo do arquivo para miniaturas enviadas aumentou de 2 MB para 50 MB. - A descrição do método
playlistImages.insertfoi atualizada para indicar que o tamanho máximo do arquivo para imagens enviadas aumentou de 2 MB para 50 MB.
11 de setembro de 2026
A definição da propriedade snippet.thumbnails.(key) foi atualizada na
documentação de referência dos recursos activities,
liveBroadcasts,
playlistItems,
playlists,
search
e videos
para indicar que tamanhos de miniatura de resolução mais alta estão já disponíveis para
alguns vídeos: fhd (1080p), qhd (1440p) e uhd (4K).
1º de setembro de 2026
O método videos.getRating agora aceita
o escopo de autorização https://www.googleapis.com/auth/youtube.readonly.
27 de agosto de 2026
O YouTube vai alinhar a contagem de visualizações públicas para todos os formatos de vídeo: vídeos longos, transmissões ao vivo e Shorts. O YouTube vai contar as visualizações públicas assim que o vídeo começar a ser reproduzido.
A qualificação para monetização e a maioria das principais métricas de performance não são afetadas, já que continuam ancoradas nas métricas de engajamento. Os ganhos dos criadores vão continuar baseados nas "Visualizações intencionais de Shorts" e nas "Horas intencionais de exibição", que podem ser conferidas no YouTube Analytics > Modo avançado.
A qualificação para o Programa de Parcerias do YouTube também não muda. Os requisitos de entrada no Programa de Parcerias do YouTube também serão chamados de "visualizações qualificadas de Shorts" e "horas qualificadas de exibição" (antes "visualizações públicas válidas de Shorts" e "horas de exibição públicas válidas").
Para saber mais, consulte Como funciona o desempenho do conteúdo no YouTube.
| Métrica | Status | Gatilho | Usado para |
|---|---|---|---|
| Ver | Atualizado | O vídeo é reproduzido a partir do primeiro frame (inclui reprodução automática, manter o ponteiro sobre o vídeo e clicar/tocar para reproduzir). | Contagens de visualizações públicas padrão. |
| Visualização engajada | Não alterado | A reprodução continua após o primeiro frame ou o usuário clica/toca para reproduzir. | Monetização pelo Programa de Parcerias do YouTube, a maioria das análises principais (taxa de cliques, duração média da visualização) e relatórios de engajamento. |
| Impressão de miniatura | Não alterado | A miniatura é exibida sem interação ou reprodução automática. | Mede a exposição e o empacotamento no nível do feed. |
Atualizações na documentação da API: atualizamos a descrição do campo viewCount
na documentação de referência de
canais e vídeos.
6 de agosto de 2026
Esta atualização contém as seguintes alterações:
- Todas as referências aos campos
contentDetails.likeecontentDetails.favoriteemactivities.contentDetailsforam removidas da documentação pública, já que esses campos não são retornados pela API.
7 de julho de 2026
Esta atualização contém as seguintes alterações:
A API agora é compatível com a parte brandPartner no recurso videos. Essa parte
contém detalhes sobre a marca parceira vinculada ao vídeo para
acesso da marca parceira
iniciado pelo criador de conteúdo.
A parte brandPartner pode ser especificada ao chamar os seguintes métodos:
O objeto brandPartner contém estes campos:
channelId: o ID do canal externo da marca parceira.channelHandle: o identificador do canal da marca parceira.
É necessário definir channelId ou channelHandle ao estabelecer um link, mas
apenas channelId é retornado na resposta.
23 de junho de 2026
Esta atualização contém as seguintes alterações:
- Todas as referências aos tipos de recurso
messageDeletedEventemessageRetractedEvent(e aos objetosmessageDeletedDetailsemessageRetractedDetailscorrespondentes) emliveChatMessagesforam removidas, já que esses eventos não estão sendo retornados pela API.
3 de junho de 2026
Esta atualização contém as seguintes alterações:
A API agora é compatível com um novo método,
videos.batchGetStats, que recupera
uma lista de estatísticas de vídeo que correspondem aos parâmetros de solicitação de API.
Uma chamada para esse método tem um custo de cota de 1 unidade no próprio bucket de cota granular. A cota padrão do método é de 10.000 unidades por dia.
1º de junho de 2026
A API YouTube Data está migrando para um sistema de cotas granular que abrange
conjuntos menores de métodos, começando com
videos.insert e
search.list.
Essa atualização simplifica o processo de aumento de cotas, permitindo que o YouTube verifique e aprove solicitações com base no uso de métodos específicos. Essa transição também é uma parte fundamental do nosso compromisso com a estabilidade e a segurança da plataforma, garantindo que todos os desenvolvedores possam operar em um ecossistema protegido e manter os níveis de acesso necessários para os casos de uso aprovados.
As chamadas de API para os métodos videos.insert e search.list serão cobradas nos
respectivos buckets de cota. As chamadas de API para todos os outros métodos serão
cobradas no bucket de cota atual. Os desenvolvedores podem conferir os limites de cota no
Console do Google Cloud e solicitar
mais cotas pelo
formulário de extensão de cota.
4 de dezembro de 2025
A documentação da API YouTube Data e a Calculadora de Cota foram atualizadas para refletir uma mudança no custo de cota do envio de um vídeo, que passou de aproximadamente 1.600 unidades para cerca de 100 unidades.
10 de julho de 2025
A partir de 21 de julho de 2025, o YouTube vai ajustar o conteúdo retornado pelo gráfico mostPopular do método video.list. No
passado, o gráfico mostPopular refletia os vídeos que apareciam na lista
"Em alta". Agora, o ranking mostPopular vai incluir vídeos em destaque das paradas de músicas, filmes e jogos em alta. Essa mudança na API está relacionada à descontinuação da
página "Em alta" do YouTube.
26 de março de 2025
A partir de 31 de março de 2025, o YouTube vai mudar a forma de contar as visualizações dos Shorts. No passado, para os Shorts, uma visualização era contabilizada depois que um Shorts era reproduzido por um determinado número de segundos. Agora, as visualizações vão contabilizar quantas vezes o Shorts começa a ser reproduzido ou reprisado, sem um tempo mínimo de exibição. Saiba mais
A partir de 31 de março de 2025, os seguintes campos na API Data vão retornar a contagem de visualizações dos Shorts de acordo com essa mudança:
channels.statistics.viewCountvideos.statistics.viewCount
30 de outubro de 2024
A API agora pode identificar vídeos que contêm conteúdo realista alterado ou sintético (A/S). Saiba mais sobre as políticas do YouTube relacionadas a conteúdo com restrição de idade.
Exemplos de conteúdo de AS incluem vídeos que:
- Fazer uma pessoa real parecer dizer ou fazer algo que não disse nem fez
- Alterar a filmagem de um evento ou lugar real
- Gerar uma cena com aparência realista que não existiu de verdade
Para indicar se um vídeo tem conteúdo A/S, defina a propriedade
status.containsSyntheticMedia. Essa propriedade pode ser definida ao chamar os métodos videos.insert ou videos.update. Se definida, a propriedade
é retornada no recurso video.
30 de abril de 2024
Esta atualização contém as seguintes alterações:
A API não oferece mais suporte à inserção ou recuperação de discussões de canais. Essa mudança é consistente com a funcionalidade do site do YouTube, que não permite postar comentários em canais.
13 de março de 2024
Esta atualização contém as seguintes alterações:
O parâmetro sync para os métodos
captions.insert e
captions.update foi
descontinuado. O YouTube vai deixar de oferecer suporte ao parâmetro a partir de 12 de abril de 2024.
Como resultado dessa mudança, os desenvolvedores precisam incluir informações de tempo ao inserir ou atualizar faixas de legenda. Caso contrário, o upload vai falhar.
12 de março de 2024
Esta atualização contém as seguintes alterações:
A documentação do recurso captions foi atualizada para indicar que o
comprimento máximo permitido para o
campo snippet.name é de 150
caracteres. A API vai retornar um erro
nameTooLong
se o nome da faixa for maior que isso.
7 de março de 2024
A propriedade de recurso brandingSettings.channel.moderateComments de channel foi descontinuada. O YouTube vai
deixar de oferecer suporte ao parâmetro a partir de 7 de março de 2024.
31 de janeiro de 2024
Esta atualização contém as seguintes alterações:
O novo parâmetro forHandle do método channels.list permite recuperar informações sobre um canal especificando o identificador do YouTube.
9 de novembro de 2023
Todas as referências ao recurso videoId em
Comments
foram removidas, já que o recurso videoId não está sendo retornado usando uma chamada
de API.
12 de setembro de 2023
O uso do método comments.markAsSpam foi
descontinuado há vários anos. Esse método já não é compatível com o YouTube
e não é mais compatível com a API.
Um aviso de descontinuação foi adicionado a todos os documentos que fazem referência ao
método comments.markAsSpam.
22 de agosto de 2023
O método search.list agora é compatível com o parâmetro videoPaidProductPlacement. Com esse parâmetro, é possível filtrar os resultados da pesquisa para incluir apenas
vídeos que o criador de conteúdo indicou como tendo uma promoção paga.
18 de agosto de 2023
A definição da liveStreamingDetails.concurrentViewers do recurso video foi atualizada para indicar que as contagens de visualizações simultâneas retornadas pela API YouTube Data podem ser diferentes das contagens de visualizações simultâneas processadas e sem spam disponíveis no YouTube Analytics. A
Central de Ajuda do YouTube
oferece mais informações sobre as métricas de transmissão ao vivo.
7 de agosto de 2023
Conforme anunciado em 12 de junho de 2023, o parâmetro relatedToVideoId do método search.list foi descontinuado. Esse parâmetro não é mais aceito, e as referências a ele foram removidas da documentação da API.
28 de junho de 2023
O método thumbnails.set agora é compatível com o erro uploadRateLimitExceeded, que indica que o canal enviou muitas miniaturas nas últimas 24 horas e deve tentar novamente mais tarde.
12 de junho de 2023
O parâmetro relatedToVideoId do método search.list foi descontinuado. O YouTube vai deixar de oferecer suporte
ao parâmetro a partir de 7 de agosto de 2023.
No momento, um aviso de descontinuação foi adicionado à documentação do método
search.list. Esse parâmetro será totalmente removido da documentação do search.list
em 7 de agosto de 2023 ou depois.
Além disso, um exemplo que demonstra como recuperar vídeos relacionados foi removido do guia de implementação da API.
22 de agosto de 2022
As anotações de tipo para os campos video.statistics foram corrigidas de long sem sinal para string.
5 de agosto de 2022
O YouTube mudou a forma como os IDs de legenda são gerados e, como parte dessa mudança, está atribuindo novos IDs a todas as faixas de legenda. Essa mudança pode ser
incompatível com versões anteriores para aplicativos que armazenam
valores caption_id, mas não afeta
aplicativos que não armazenam valores
caption_id.
Até 1º de dezembro de 2022, os métodos
captions.list,
captions.update,
captions.download e
captions.delete vão aceitar os IDs de faixa de legenda
antigos e novos. No entanto, a partir de 1º de dezembro de 2022,
o YouTube vai deixar de oferecer suporte aos IDs de faixa de legenda antigos. Nesse momento, chamar
qualquer um desses métodos de API com um ID de faixa de legenda antigo vai resultar em um
erro captionNotFound.
Para se preparar para essa mudança, planeje substituir totalmente todos os dados de faixas de legenda armazenados até 1º de dezembro de 2022. Isso significa que, para qualquer vídeo em que você armazena dados de faixa de legenda, é necessário excluir os dados armazenados e, em seguida, chamar o método captions.list para recuperar o conjunto atual de faixas de legenda do vídeo e armazenar os dados na resposta da API como você faria normalmente.
12 de julho de 2022
Os Termos de Serviço dos serviços de APIs do YouTube foram atualizados. Consulte o Histórico de revisões dos serviços de APIs do YouTube para mais informações.
27 de abril de 2022
A descrição do método videos.insert foi
atualizada para indicar que o tamanho máximo do arquivo para vídeos enviados
aumentou de 128 GB para 256 GB.
8 de abril de 2022
As definições dos parâmetros
myRecentSubscribers
e mySubscribers
do método subscriptions.list foram atualizadas para indicar que o número máximo de
inscritos retornados pela API pode ser limitado. Essa mudança representa uma
correção na documentação, não uma mudança no comportamento da API.
15 de dezembro de 2021
Conforme anunciado em
18 de novembro de 2021,
em conjunto com as mudanças para tornar privadas as contagens de marcações "Não gostei" em toda a
plataforma do YouTube, a
propriedade
statistics.dislikeCount
do recurso video agora é privada.
Saiba mais sobre essa mudança no blog oficial do YouTube.
18 de novembro de 2021
Em conjunto com as mudanças para tornar as contagens de marcações "Não gostei" privadas em toda a plataforma do YouTube, a propriedade statistics.dislikeCount do recurso video será privada a partir de 13 de dezembro de 2021. Isso significa que a propriedade só será incluída em uma resposta da API do endpoint videos.list se a solicitação de API tiver sido autenticada pelo proprietário do vídeo.
O endpoint videos.rate não é afetado por
essa mudança.
Os desenvolvedores que não mostram publicamente as contagens de marcações "Não gostei" e ainda precisam delas para o cliente da API podem solicitar uma isenção para serem incluídos em uma lista de permissões. Para solicitar uma isenção, preencha este formulário de inscrição.
Saiba mais sobre essa mudança no blog oficial do YouTube.
2 de julho de 2021
O endpoint commentThreads.update foi descontinuado e não é mais
compatível. Esse endpoint duplicava a funcionalidade disponível em outros endpoints de API. Em vez disso, chame o método
comments.update
e, se o código exigir um recurso commentThreads, faça uma chamada secundária para o método commentThreads.list.
1º de julho de 2021
Todos os desenvolvedores que usam os Serviços de API do YouTube precisam concluir uma auditoria de conformidade da API para receber mais do que a alocação de cota padrão de 10.000 unidades. Até o momento, tanto o processo de auditoria de compliance quanto as solicitações de alocações de unidades de cota extras eram realizados por desenvolvedores que preenchiam e enviavam o formulário de auditoria e extensão de cota dos serviços de APIs do YouTube.
Para esclarecer esses processos e atender melhor às necessidades dos desenvolvedores que usam nossos Serviços de API, estamos adicionando três novos formulários e um guia para preenchê-los:
- Formulário de auditoria e extensão de cota: os desenvolvedores que já passaram por uma auditoria de compliance da API podem preencher e enviar este formulário (selecionando "Fazer uma auditoria de compliance para manter a cota atual (devido a um pedido para refazer a auditoria)" na primeira pergunta) para solicitar uma extensão de cota alocada.
- Formulário de contestação: os desenvolvedores com projetos de API que não passaram em uma auditoria de compliance (ou que tiveram um aumento de unidade de cota negado) podem preencher e enviar este formulário.
- Formulário de mudança de controle: desenvolvedores ou qualquer parte que opere um cliente de API em nome de um desenvolvedor e que passe por uma mudança de controle (por exemplo, por meio de uma compra ou venda de ações, fusão ou outra forma de transação corporativa) associada a um projeto de API precisam preencher e enviar este formulário. Isso permite que a equipe de API do YouTube atualize nossos registros, audite a conformidade do caso de uso do novo projeto de API e valide a alocação de cota atual do desenvolvedor.
Cada novo formulário vai nos informar sobre o uso pretendido da API do YouTube e nos permitir ajudar você melhor.
Confira mais detalhes no novo guia de auditorias de compliance da API.
12 de maio de 2021
Esta atualização inclui as seguintes mudanças na API:
A propriedade
contentDetails.relatedPlaylists.favoritesdo recursochannelfoi descontinuada. A funcionalidade de vídeos favoritos foi descontinuada há vários anos, conforme observado na entrada do histórico de revisões de 28 de abril de 2016.Antes dessa atualização, a API ainda criava uma nova playlist se um cliente da API tentasse adicionar um vídeo a uma playlist de favoritos inexistente. A partir de agora, a playlist não será criada nesse caso, e a API vai retornar um erro. As tentativas de modificar playlists de favoritos adicionando, modificando ou excluindo itens também foram descontinuadas, conforme anúncios anteriores, e podem começar a retornar erros a qualquer momento.
As seguintes propriedades de recurso
channelforam descontinuadas. Essas propriedades já não são compatíveis com a interface do YouTube Studio e com o YouTube. Como resultado, eles também não são mais compatíveis com a API.brandingSettings.channel.defaultTabbrandingSettings.channel.featuredChannelsTitlebrandingSettings.channel.featuredChannelsUrls[]brandingSettings.channel.profileColorbrandingSettings.channel.showBrowseViewbrandingSettings.channel.showRelatedChannels
Todas as propriedades foram removidas da representação do recurso
channel, e as definições delas foram removidas da lista de propriedades do recurso. Além disso, os erros associados a essas propriedades foram removidos da documentação específica do método.As seguintes propriedades de recurso
channelSectionforam descontinuadas. Essas propriedades já não são compatíveis com a interface do YouTube Studio e com o YouTube. Como resultado, eles também não são mais compatíveis com a API.snippet.stylesnippet.defaultLanguagesnippet.localized.titlelocalizationslocalizations.(key)localizations.(key).titletargetingtargeting.languages[]targeting.regions[]targeting.countries[]
Além disso, o parâmetro
hldo métodochannelSection.listtambém foi descontinuado, já que os recursos que ele aceita não são mais compatíveis.Todas as propriedades foram removidas da representação do recurso
channelSection, e as definições delas foram removidas da lista de propriedades do recurso. Além disso, os erros associados a essas propriedades foram removidos da documentação específica do método.Para a propriedade
snippet.typedo recursochannelSection, os valores a seguir foram descontinuados. Esses valores já não são aceitos nas páginas de canais do YouTube e, como resultado, também não são mais aceitos pela API.likedPlaylistslikespostedPlaylistspostedVideosrecentActivityrecentPosts
A propriedade
snippet.tags[]do recursoplaylistfoi descontinuada. Essa propriedade já não é compatível com o YouTube e, como resultado, não é mais compatível com a API.
9 de fevereiro de 2021
O recurso playlistItem agora aceita duas novas propriedades:
- A propriedade
snippet.videoOwnerChannelIdidentifica o ID do canal que enviou o vídeo da playlist. - A propriedade
snippet.videoOwnerChannelTitleidentifica o nome do canal que enviou o vídeo da playlist.
28 de janeiro de 2021
Esta atualização contém as seguintes alterações:
Os métodos
playlistItems.delete,playlistItems.insert,playlistItems.list,playlistItems.update,playlists.delete,playlists.listeplaylists.updateagora são compatíveis com um novo erroplaylistOperationUnsupported. O erro ocorre quando uma solicitação tenta executar uma operação que não é permitida para uma playlist específica. Por exemplo, um usuário não pode excluir um vídeo da playlist de vídeos enviados nem excluir a playlist em si.Em todos os casos, esse erro retorna um código de resposta HTTP
400(solicitação inválida).Os erros
watchHistoryNotAccessibleewatchLaterNotAccessibledo métodoplaylistItems.listforam removidos da documentação. Embora o histórico de exibição e as listas de assistir mais tarde dos usuários não sejam acessíveis usando a API, esses erros específicos não são retornados pela API.
15 de outubro de 2020
Duas novas seções foram adicionadas às Políticas para Desenvolvedores:
- A nova Seção III.E.4.i oferece mais informações sobre a coleta de dados e os dados enviados pelo player incorporado do YouTube. Você é responsável por todos os dados do usuário que nos enviar por qualquer player incorporado do YouTube antes que o usuário interaja com o player para indicar a intenção de reprodução. Para limitar o compartilhamento de dados pessoais com o YouTube antes que uma interação do usuário ocorra com o player, defina a reprodução automática como "false".
- A nova Seção III.E.4.j se refere à verificação do status de conteúdo para crianças (MFK, na sigla em inglês) antes de incorporar esse conteúdo nos seus sites e apps. Você é responsável por saber quando os vídeos incorporados no seu cliente de API são conteúdo para crianças e tratar os dados coletados do player incorporado de acordo com isso. Portanto, você precisa verificar o status do conteúdo usando o serviço da API YouTube Data antes de incorporá-lo ao seu cliente de API usando qualquer player incorporado do YouTube.
O novo guia Como encontrar o status de conteúdo para crianças de um vídeo explica como consultar o status de conteúdo para crianças de um vídeo usando o serviço da API YouTube Data.
Além dessas mudanças, adicionamos um lembrete à documentação de parâmetros do player incorporado para explicar que, se você ativar a reprodução automática, a reprodução vai ocorrer sem qualquer interação do usuário com o player. Portanto, a coleta de dados e o compartilhamento vão ocorrer no carregamento de página.
8 de outubro de 2020
Esta atualização abrange três pequenas mudanças relacionadas ao recurso channel:
- O objeto
snippet.thumbnails, que identifica as imagens de miniatura de um canal, pode estar vazio para canais recém-criados e pode levar até um dia para ser preenchido. - A propriedade
statistics.videoCountreflete apenas a contagem de vídeos públicos do canal, mesmo para os proprietários. Esse comportamento é consistente com as contagens mostradas no site do YouTube. - As palavras-chave do canal, identificadas na propriedade
brandingSettings.channel.keywords, podem ser truncadas se excederem o limite de caracteres máximo permitido de 500 caracteres ou se contiverem aspas sem escape ("). O limite de 500 caracteres não é por palavra-chave, mas sim um limite para o tamanho total de todas as palavras-chave. Esse comportamento é consistente com o do site do YouTube.
9 de setembro de 2020
Esta atualização abrange as seguintes mudanças na API. Todas as mudanças vão entrar em vigor em 9 de setembro de 2020, data deste aviso, ou depois. Por isso, os desenvolvedores não devem mais usar os seguintes recursos da API.
Os seguintes recursos, métodos, parâmetros e propriedades de recursos da API foram descontinuados imediatamente e deixarão de funcionar a partir da data deste aviso:
As seguintes propriedades de recurso
channel:A propriedade
statistics.commentCountO objeto
brandingSettings.imagee todas as propriedades filhas deleA lista
brandingSettings.hintse todas as propriedades filhas delaO parâmetro de filtro
categoryIddo métodochannels.listO recurso
guideCategoriese o métodoguideCategories.list
As respostas da API para o método
channels.listnão contêm mais a propriedadeprevPageTokense a solicitação de API definir o parâmetromanagedByMecomotrue. Essa mudança não afeta a propriedadeprevPageTokende outras solicitaçõeschannels.listnem a propriedadenextPageTokende nenhuma solicitação.As propriedades
contentDetails.relatedPlaylists.watchLaterecontentDetails.relatedPlaylists.watchHistorydo recursochannelforam anunciadas como descontinuadas em 11 de agosto de 2016. A compatibilidade dos métodosplaylistItems.inserteplaylistItems.deletecom essas playlists também foi totalmente descontinuada, e as duas propriedades foram removidas da documentação.O parâmetro
mySubscribersdo métodochannels.list, que foi anunciado como descontinuado em 30 de julho de 2013, foi removido da documentação. Use o métodosubscriptions.liste o parâmetromySubscriberspara recuperar uma lista de inscritos no canal do usuário autenticado.O objeto
invideoPromotiondo recursochannele todas as propriedades filhas, que foram anunciadas como descontinuadas em 27 de novembro de 2017, foram removidos da documentação.
29 de julho de 2020
Simplificamos nosso processo de cobrança de cota para solicitações de API removendo
o custo extra associado ao parâmetro part. A partir de agora,
vamos cobrar apenas o custo base do método chamado. Para mais
informações sobre a cota simplificada, consulte a
Calculadora de cotas.
O efeito dessa mudança é que a maioria das chamadas de API terá um custo de cota ligeiramente menor, enquanto algumas chamadas de API ainda terão o mesmo custo. Essa mudança não aumenta o custo das chamadas de API. No geral, o impacto provável é que sua cota de alocação, que pode ser vista no Console do Google Cloud, vai durar um pouco mais.
Recomendamos que todos os desenvolvedores concluam uma auditoria de conformidade nos projetos para garantir o acesso contínuo aos serviços de APIs do YouTube.
28 de julho de 2020
Todos os vídeos enviados usando o 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 privada. Para suspender essa restrição, cada projeto precisa
passar por uma auditoria para
verificar a conformidade com os
Termos de Serviço.
Os criadores de conteúdo que usarem um cliente de API não verificado para enviar vídeos vão receber um e-mail explicando que o conteúdo foi bloqueado como privado e que é possível evitar essa restrição usando um cliente oficial ou auditado.
Os projetos de API criados antes de 28 de julho de 2020 não são afetados por essa mudança. No entanto, recomendamos que todos os desenvolvedores concluam uma auditoria de conformidade nos projetos para garantir o acesso contínuo aos serviços de APIs do YouTube.
21 de julho de 2020
Ontem, publicamos uma atualização na documentação relacionada ao nosso processo de cobrança de cotas. No entanto, devido a circunstâncias imprevistas, a mudança de cota ainda não está em vigor. Por isso, a documentação foi revertida para garantir a precisão. Para evitar confusão, a entrada do histórico de revisões que explica a mudança foi removida e será republicada em breve.
7 de julho de 2020
Os parâmetros autoLevels e stabilize do método videos.insert foram descontinuados e removidos da documentação. Os valores deles são ignorados e não afetam a forma como os vídeos recém-enviados são processados.
15 de junho de 2020
O novo guia Conformidade com as Políticas para Desenvolvedores do YouTube oferece orientações e exemplos para ajudar você a garantir que seus clientes de API sigam partes específicas dos Termos e das Políticas dos Serviços de APIs do YouTube (TOS da API).
Essas orientações oferecem insights sobre como o YouTube aplica determinados aspectos dos TOS da API, mas não substituem nenhum documento existente. O guia aborda algumas das perguntas mais comuns que os desenvolvedores fazem durante as auditorias de compliance da API. Esperamos que ele simplifique o processo de desenvolvimento de recursos, ajudando você a entender como interpretamos e aplicamos nossas políticas.
4 de junho de 2020
O recurso de boletim do canal foi totalmente descontinuado. Essa mudança foi
anunciada inicialmente em 17 de abril de 2020 e já entrou em vigor. Como resultado, o método
activities.insert não é mais
compatível, e o método activities.list
não retorna mais boletins de canais. Para mais detalhes, consulte a
Central de Ajuda do YouTube.
17 de abril de 2020
O YouTube está descontinuando o recurso de boletim do canal. Como resultado, o método
activities.insert será
descontinuado, e o método activities.list
vai parar de retornar boletins de canais. Essas mudanças vão entrar em vigor na API a partir de 18 de maio de 2020. Para mais detalhes, consulte a
Central de Ajuda do YouTube.
31 de março de 2020
Esta atualização contém as seguintes alterações:
Novos recursos e métodos
- O novo recurso
memberrepresenta um membro de um canal do YouTube. Um membro oferece apoio financeiro recorrente a um criador de conteúdo e recebe benefícios especiais. Por exemplo, os membros podem conversar quando o criador ativa o modo exclusivo para membros em um chat.
Esse recurso substitui o
sponsor, que está documentado como parte da API YouTube Live Streaming. O recursosponsorfoi descontinuado, e os clientes de API precisam atualizar as chamadas para o métodosponsors.listpara usar o métodomembers.list.- O novo recurso
membershipsLevelidentifica um nível de preço gerenciado pelo criador de conteúdo que autorizou a solicitação da API. O métodomembershipsLevels.listrecupera uma lista de todos os níveis da assinatura do criador de conteúdo.
- O novo recurso
10 de janeiro de 2020
Agora a API é compatível com a identificação de conteúdo direcionado a crianças, que o YouTube chama de "conteúdo para crianças". Saiba mais sobre conteúdo para crianças na Central de Ajuda do YouTube.
Os recursos channel e
video são compatíveis com duas novas propriedades para
permitir que criadores de conteúdo e espectadores identifiquem conteúdo para crianças:
A propriedade
selfDeclaredMadeForKidspermite que os criadores de conteúdo especifiquem se um canal ou vídeo é conteúdo para crianças.Para canais, essa propriedade pode ser definida ao chamar o método
channels.update. Para vídeos, essa propriedade pode ser definida ao chamar os métodosvideos.insertouvideos.update.Essa propriedade só é incluída nas respostas da API que contêm recursos
channelouvideose o proprietário do canal autorizou a solicitação de API.A propriedade
madeForKidspermite que qualquer usuário recupere o status "conteúdo para crianças" de um canal ou vídeo. Por exemplo, o status pode ser determinado com base no valor da propriedadeselfDeclaredMadeForKids. Acesse a Central de Ajuda do YouTube para mais informações sobre como definir o público do seu canal, vídeos ou transmissões.
Também atualizamos os Termos de Serviço dos serviços de APIs do YouTube e as Políticas para Desenvolvedores. Para mais informações, consulte os Termos de Serviço dos serviços de APIs do YouTube: histórico de revisões. As mudanças nos Termos de Serviço dos serviços de APIs do YouTube e nas Políticas para Desenvolvedores vão entrar em vigor em 10 de janeiro de 2020, no Horário do Pacífico.
10 de setembro de 2019
A documentação de referência da API foi atualizada para refletir uma mudança na forma como as contagens de inscritos são informadas no YouTube e, consequentemente, nas respostas da API. Como resultado da mudança, as contagens de inscritos retornadas pelo serviço da API YouTube Data são arredondadas para baixo para três dígitos significativos quando o canal tem mais de 1.000 inscritos. Essa mudança afeta a propriedade channel
statistics.subscriberCount
do recurso.
Por exemplo, se um canal tiver 123.456 inscritos, a propriedade statistics.subscriberCount vai conter o valor 123000. A
tabela abaixo mostra exemplos de como as contagens de inscritos são arredondadas nas respostas
da API e abreviadas em outras interfaces do usuário do YouTube visíveis publicamente:
| Exemplo de contagem de inscritos | API YouTube Data | Interfaces do YouTube visíveis publicamente |
|---|---|---|
| 1,234 | 1230 | 1,23 mil |
| 12.345 | 12300 | 12,3 mil |
| 123.456 | 123000 | 123 mil |
| 1.234.567 | 1230000 | 1,23 mi |
| 12.345.678 | 12300000 | 12,3 mi |
| 123,456,789 | 123000000 | 123 mi |
4 de abril de 2019
Esta atualização contém as seguintes alterações:
A documentação de referência da API foi atualizada para explicar melhor os casos de uso comuns de cada método e fornecer exemplos de código dinâmicos e de alta qualidade pelo widget do APIs Explorer. Consulte a documentação do método
channels.listpara ver um exemplo. Agora há dois novos elementos nas páginas que descrevem os métodos da API:O widget do APIs Explorer permite selecionar escopos de autorização, inserir valores de amostra de parâmetros e propriedades, enviar solicitações de API reais e ver as respostas da API reais. O widget também oferece uma visualização em tela cheia que mostra exemplos de código completos, que são atualizados dinamicamente para usar os escopos e valores inseridos.
A seção Casos de uso comuns descreve um ou mais casos de uso comuns para o método explicado na página. Por exemplo, você pode chamar o método
channels.listpara recuperar dados sobre um canal específico ou sobre o canal do usuário atual.
Use os links nessa seção para preencher o APIs Explorer com valores de exemplo para seu caso de uso ou para abrir o APIs Explorer em tela cheia com esses valores já preenchidos. Essas mudanças têm como objetivo facilitar a visualização de exemplos de código que são diretamente aplicáveis ao caso de uso que você está tentando implementar no seu próprio aplicativo.
Os exemplos de código são compatíveis com Java, JavaScript, PHP, Python e curl.
A ferramenta de exemplos de código também foi atualizada com uma nova interface que oferece os mesmos recursos. Com essa ferramenta, é possível analisar casos de uso para diferentes métodos, carregar valores no APIs Explorer e abrir o APIs Explorer em tela cheia para receber exemplos de código em Java, JavaScript, PHP e Python.
Além disso, as páginas que listavam os exemplos de código disponíveis para Java, JavaScript, PHP e Python foram removidas.
Os guias de início rápido para Java, JavaScript, PHP e Python foram atualizados. Os guias revisados explicam como executar um exemplo com uma chave de API e outro com um ID do cliente OAuth 2.0 usando exemplos de código do APIs Explorer.
Essas mudanças substituem uma ferramenta interativa que foi adicionada à documentação da API em 2017.
9 de julho de 2018
Esta atualização contém as seguintes alterações:
A definição da propriedade
snippet.thumbnailsdo recursochannelfoi atualizada para indicar que, ao exibir miniaturas no seu aplicativo, o código precisa usar os URLs de imagem exatamente como são retornados nas respostas da API. Por exemplo, seu aplicativo não deve usar o domíniohttpem vez do domíniohttpsem um URL retornado em uma resposta da API.A partir de julho de 2018, os URLs de miniatura de canal só estarão disponíveis no domínio
https, que é como eles aparecem nas respostas da API. Depois disso, talvez você veja imagens corrompidas no seu aplicativo se ele tentar carregar imagens do YouTube do domíniohttp.-
A propriedade
recordingDetails.location.altitudedo recursovideofoi descontinuada. Não há garantia de que os vídeos vão retornar valores para essa propriedade. Da mesma forma, mesmo que as solicitações de API tentem definir um valor para essa propriedade, é possível que os dados recebidos não sejam armazenados.
22 de junho de 2018
O Guia de implementação, antes conhecido como Guia de implementação e migração, foi atualizado para remover as instruções de migração da API v2 para a API v3. Além disso, as instruções também foram removidas para recursos que foram descontinuados na API v3, como vídeos favoritos.
27 de novembro de 2017
Esta atualização contém as seguintes alterações:
-
O YouTube está removendo o suporte aos recursos Vídeo em destaque e Site em destaque, que são compatíveis com a API usando o objeto
invideoPromotiondo recursochannel. Como resultado, esse objeto, incluindo todas as propriedades filhas, está sendo descontinuado.Você ainda pode recuperar e definir dados de
invideoPromotionaté 14 de dezembro,- Depois dessa data:
- As tentativas de recuperar a parte
invideoPromotionao chamarchannels.listvão retornar uminvideoPromotionvazio ou não vão retornar nenhum dado deinvideoPromotion. - As tentativas de atualizar os dados de
invideoPromotionao chamarchannels.updatevão retornar uma resposta bem-sucedida até pelo menos 27 de maio de 2018, mas serão tratadas como no-ops, ou seja, não vão realizar uma atualização.
Depois de 27 de maio de 2018, é possível que essas solicitações retornem mensagens de erro para indicar, por exemplo, que
invalidPromotioné uma parte inválida.
16 de novembro de 2017
Esta atualização contém as seguintes alterações:
A ferramenta de snippet de código interativo agora é compatível com exemplos de código Node.js. Os exemplos também estão visíveis na documentação de quase todos os métodos de API, como o método
channels.list.As amostras personalizáveis foram projetadas para oferecer um ponto de partida específico para um caso de uso de um aplicativo Node.js. A funcionalidade é semelhante ao código no guia de início rápido do Node.js. No entanto, as amostras contêm algumas funções utilitárias que não aparecem no guia de início rápido:
A função
removeEmptyParametersusa uma lista de pares de chave-valor correspondentes aos parâmetros de solicitação de API e remove os parâmetros que não têm valores.A função
createResourceusa uma lista de pares de chave-valor correspondentes às propriedades em um recurso de API. Em seguida, ele converte as propriedades em um objeto JSON que pode ser usado em operaçõesinserteupdate. O exemplo a seguir mostra um conjunto de nomes e valores de propriedade e o objeto JSON que o código criaria para eles:
# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }Todas essas amostras foram projetadas para serem baixadas e executadas localmente. Para mais informações, consulte os pré-requisitos para executar exemplos de código completos localmente nas instruções da ferramenta de snippet de código.
25 de outubro de 2017
Esta atualização contém as seguintes alterações:
Os exemplos de código Python na ferramenta de snippet de código interativo foram atualizados para usar as bibliotecas
google-authegoogle-auth-oauthlibem vez da bibliotecaoauth2client, que foi descontinuada.Além dessa mudança, a ferramenta agora fornece exemplos de código completos para aplicativos Python instalados e aplicativos de servidor da Web Python, que usam fluxos de autorização um pouco diferentes. Para ver as amostras completas (e essa mudança):
- Acesse a
ferramenta interativa de snippet de código ou
a documentação de qualquer método de API, como o
método
channels.list. - Clique na guia
Pythonacima dos exemplos de código. - Clique no botão acima das guias para alternar entre um snippet e um exemplo completo.

- A guia agora mostra um exemplo de código completo que usa o
fluxo de autorização
InstalledAppFlow. A descrição acima do exemplo explica isso e também inclui um link para um exemplo de aplicativo de servidor da Web. - Clique no link para mudar para o exemplo de servidor da Web. Esse exemplo usa o framework de aplicativo da Web Flask e um fluxo de autorização diferente.
Todas essas amostras foram projetadas para serem baixadas e executadas localmente. Se você quiser executar os exemplos de código, consulte as instruções para executar exemplos de código completos localmente nas instruções da ferramenta de snippet de código.
- Acesse a
ferramenta interativa de snippet de código ou
a documentação de qualquer método de API, como o
método
29 de agosto de 2017
Esta atualização contém as seguintes alterações:
- A definição do parâmetro
forContentOwnerdo métodosearch.listfoi atualizada para indicar que, se esse parâmetro for definido comotrue, o parâmetrotypeprecisará ser definido comovideo. - A definição do parâmetro
regionCodedo métodosearch.listfoi atualizada para esclarecer que o parâmetro restringe os resultados da pesquisa a vídeos que podem ser visualizados na região especificada. - O YouTube atualizou os logotipos e ícones da marca. Os novos logotipos "desenvolvido com o YouTube" podem ser baixados na página de diretrizes de branding. Outros logotipos e ícones novos do YouTube também são mostrados nessa página e podem ser baixados no site da marca do YouTube.
24 de julho de 2017
Esta atualização contém as seguintes alterações:
Um novo guia de início rápido da API YouTube Data está disponível para iOS. O guia explica como usar a API YouTube Data em um aplicativo iOS básico escrito em Objective-C ou Swift.
A ferramenta de snippet de código interativo da API YouTube Data agora inclui documentação que explica alguns dos recursos da ferramenta:
- Como executar solicitações de API
- Alternar entre snippets de código e exemplos de código completos
- Como usar funções boilerplate
- Carregar recursos atuais (para métodos de atualização)
1º de junho de 2017
Esta atualização contém as seguintes alterações:
-
As seguintes propriedades de recurso
videoestão sendo descontinuadas. Embora as propriedades sejam compatíveis até 1º de dezembro de 2017, não há garantia de que os vídeos continuarão retornando valores para essas propriedades até essa data. Da mesma forma, as solicitaçõesvideos.insertevideos.updateque definem esses valores de propriedade não vão gerar erros antes dessa data, mas é possível que os dados recebidos não sejam armazenados.
17 de maio de 2017
Esta atualização contém as seguintes alterações:
A documentação de referência da API foi atualizada para tornar os snippets de código mais onipresentes e interativos. As páginas que explicam os métodos da API, como
channels.listouvideos.rate, agora têm uma ferramenta interativa que permite visualizar e personalizar snippets de código em Java, JavaScript, PHP, Python, Ruby, Apps Script e Go.Para qualquer método, a ferramenta mostra snippets de código para um ou mais casos de uso, e cada caso de uso descreve uma maneira comum de chamar esse método. Por exemplo, você pode chamar o método
channels.listpara recuperar dados sobre um canal específico ou sobre o canal do usuário atual.Também é possível interagir com exemplos de código:
- Modifique os valores de parâmetros e propriedades, e os snippets de código serão atualizados dinamicamente para refletir os valores fornecidos.
- Alternar entre snippets de código e amostras completas. Um snippet de código mostra a parte do código que chama o método da API. Um exemplo completo contém esse snippet, bem como o código boilerplate para autorizar e enviar solicitações. As amostras completas podem ser copiadas e executadas na linha de comando ou em um servidor da Web local.
- Executar solicitações clicando em um botão. Para executar solicitações, é necessário autorizar a ferramenta a chamar a API em seu nome.
Essa ferramenta substituiu o APIs Explorer nas páginas em que está disponível. Cada página exibe um link para que você também tenha a opção de carregar a solicitação em que está trabalhando no APIs Explorer.
A ferramenta Snippets de código da API Data também foi atualizada com uma nova interface que oferece os mesmos recursos. Os principais novos recursos disponíveis nesta página são:
- Suporte para solicitações de API que gravam dados.
- Suporte para exemplos em Java.
- Código boilerplate mais flexível e abrangente para autorizar usuários e criar solicitações de API.
27 de abril de 2017
Esta atualização contém as seguintes alterações:
- Os novos guias de início rápido explicam como configurar um aplicativo básico que faz solicitações da API YouTube Data. Os guias estão disponíveis para Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python e Ruby.
30 de março de 2017
Esta atualização contém as seguintes alterações:
- A nova propriedade
topicDetails.topicCategories[]do recursochannelcontém uma lista de URLs da Wikipédia que descrevem o conteúdo do canal. Os URLs correspondem aos IDs de tema retornados na propriedadetopicDetails.topicIds[]do recurso. - A nova propriedade
contentDetails.videoPublishedAtdo recursoplaylistItemidentifica o momento em que o vídeo foi publicado no YouTube. O recurso já contém a propriedadesnippet.publishedAt, que identifica o momento em que o item foi adicionado à playlist. - Assim como o recurso
channel, o recursovideoagora retorna a propriedadetopicDetails.topicCategories[], que contém uma lista de URLs da Wikipédia que descrevem o conteúdo do vídeo. Para recursosvideo, os URLs correspondem aos IDs de tópico retornados na propriedadetopicDetails.relevantTopicIds[]do recurso. - A nova propriedade
contentDetails.contentRating.mpaatRatingdo recursovideoidentifica a classificação que a Motion Picture Association of America atribuiu a um trailer ou prévia de filme.
27 de fevereiro de 2017
Como anunciado em 11 de agosto de 2016, o YouTube
mudou a lista de IDs de tópicos compatíveis para uma lista selecionada. A lista completa de
IDs de tópicos compatíveis está incluída nas propriedades topicDetails dos recursos
channel e
video, bem como no
parâmetro topicId do método
search.list.
Há várias mudanças na lista selecionada:
- Os seguintes tópicos foram adicionados como subtópicos de
Society:Nome ID do tópico Negócios /m/09s1fSaúde /m/0kt51Militar /m/01h6rjPolítica /m/05qt0Religião /m/06bvp - O tópico
Animated cartoon, que antes era filho deEntertainment, foi removido. - O tópico
Children's music, que antes era filho deMusic, foi removido.
Como resultado dessa mudança, os tópicos relacionados a um vídeo agora são sempre retornados no valor da propriedade topicDetails.relevantTopicIds[] do recurso video.
29 de novembro de 2016
Esta atualização contém as seguintes alterações:
Há três pequenas mudanças na lista de IDs de tópicos que serão aceitos a partir de 10 de fevereiro de 2017:
- A categoria
Professional wrestling, que antes era filha da categoriaSports, agora é filha deEntertainment. - A categoria
TV shows, que é filha deEntertainment, é nova. - A categoria
Health, que antes era filha deLifestyle, foi removida.
Além disso, há algumas categorias principais (
Entertainment,Gaming,Lifestyle,MusiceSports). Qualquer vídeo associado a uma categoria secundária, comoTennis, também será associado à categoria principal (Sports).- A categoria
10 de novembro de 2016
Esta atualização contém as seguintes alterações:
Como anunciado em 11 de agosto de 2016, a descontinuação do Freebase e da API Freebase exige várias mudanças relacionadas aos IDs de tópicos. Os IDs de tema identificam temas associados aos recursos
channelevideo. Você também pode usar o parâmetro de pesquisatopicIdpara encontrar canais ou vídeos relacionados a um tema específico.Em 10 de fevereiro de 2017, o YouTube vai começar a retornar um pequeno conjunto de IDs de tópicos, em vez do conjunto muito mais granular de IDs retornados até o momento. Além disso, não há garantia de que os canais e vídeos estejam associados a algum tópico, o que é consistente com o comportamento atual da API.
Para que você possa preparar seus clientes de API para essas mudanças, as definições dos seguintes parâmetros e propriedades de API foram atualizadas para listar os IDs de temas que serão aceitos após esse período. A lista de categorias é igual para todas as propriedades.
- A propriedade
topicDetails.topicIds[]do recursochannel. - A propriedade
topicDetails.relevantTopicIds[]do recursovideo. - O parâmetro
topicIddo métodosearch.list.
- A propriedade
-
As seguintes propriedades serão descontinuadas:
- A propriedade
topicDetails.topicIds[]do recursochannel. Essa propriedade será aceita até 10 de novembro de 2017. - A propriedade
topicDetails.relevantTopicIds[]do recursovideo. Essa propriedade será aceita até 10 de novembro de 2017. - A propriedade
topicDetails.topicIds[]do recursovideo. Essa propriedade não vai conter valores após 10 de fevereiro de 2017. Depois dessa data, o valor da propriedadetopicDetails.relevantTopicIds[]vai identificar todos os tópicos associados a um vídeo.
- A propriedade
Como o Freebase já foi descontinuado, o guia Pesquisa com tópicos do Freebase foi removido da documentação. Esse guia forneceu exemplos de código para mostrar como um aplicativo funcionaria com a API Freebase.
Além disso, vários exemplos de código relacionados a IDs de temas foram removidos da documentação do método
search.list.
2 de novembro de 2016
Esta atualização contém as seguintes alterações:
-
Novas propriedades e parâmetros
-
O recurso
videocontém várias propriedades novas:-
A propriedade
player.embedHtmlcontém uma tag<iframe>que pode ser usada para incorporar um player que reproduz o vídeo. As novas propriedadesplayer.embedHeighteplayer.embedWidthidentificam as dimensões do player incorporado. Essas propriedades só serão retornadas se a solicitação de API especificar um valor para pelo menos um dos parâmetrosmaxHeightoumaxWidth. Esses dois novos parâmetros são explicados mais adiante nesta entrada do histórico de revisões. -
A nova propriedade
hasCustomThumbnailindica se o usuário que fez o envio do vídeo forneceu uma imagem de miniatura personalizada para ele. Essa propriedade só fica visível para quem fez o upload do vídeo. -
O novo
fpbRatingReasons[]identifica os motivos pelos quais o vídeo recebeu a classificação do FPB (África do Sul). -
O novo
mcstRatingidentifica a classificação que o vídeo recebeu no Vietnã.
-
-
O método
videos.listaceita dois novos parâmetros:maxHeightemaxWidth. É possível usar um ou os dois parâmetros ao recuperar a parteplayerem recursosvideo.Por padrão, a altura do
<iframe>retornado na propriedadeplayer.embedHtmlé de 360 px. A largura se ajusta para corresponder à proporção do vídeo, garantindo que o player incorporado não tenha barras pretas emoldurando o vídeo. Por exemplo, se a proporção de um vídeo for 16:9, a largura do player será de 640 px.Com os novos parâmetros, é possível especificar que, em vez das dimensões padrão, o código de incorporação use uma altura e/ou largura apropriada para o layout do aplicativo. O servidor de API dimensiona as dimensões do player conforme apropriado para garantir que o player incorporado não tenha barras pretas emoldurando o vídeo. Os dois parâmetros especificam as dimensões máximas do player incorporado. Assim, se ambos os parâmetros forem especificados, uma dimensão ainda poderá ser menor que o valor máximo permitido para essa dimensão.
Por exemplo, suponha que um vídeo tenha uma proporção de 16:9. Assim, a tag
player.embedHtmlvai conter um player de 640 x 360 se o parâmetromaxHeightoumaxWidthnão estiver definido.- Se o parâmetro
maxHeightfor definido como720e o parâmetromaxWidthnão for definido, a API vai retornar um player de 1280 x 720. - Se o parâmetro
maxWidthfor definido como960e o parâmetromaxHeightnão for definido, a API vai retornar um player de 960 x 540. - Se o parâmetro
maxWidthestiver definido como960e o parâmetromaxHeightestiver definido como450, a API vai retornar um player de 800 x 450.
As novas propriedades
player.embedHeighteplayer.embedWidth, descritas acima, identificam as dimensões do player. - Se o parâmetro
-
-
Atualizações de métodos, propriedades e parâmetros atuais
-
A descrição do recurso
channelSectionfoi atualizada para indicar que um canal pode criar no máximo 10 seções sem definir dados de segmentação e no máximo 100 seções com dados de segmentação.Além disso, a propriedade
targetingdo recursochannelSectionfoi atualizada para refletir o fato de que as opções de segmentação só podem ser definidas usando a API. As opções de segmentação serão excluídas se a seção do canal for modificada usando a interface do usuário no site do YouTube. -
A definição da propriedade
snippet.namedo recursoi18nLanguagefoi corrigida para refletir que o valor representa o nome de um idioma conforme escrito no idioma especificado pelo parâmetrohldo métodoi18nLanguage.list. -
A propriedade
contentDetails.notedo recursoplaylistItemfoi atualizada para indicar que o tamanho máximo do valor da propriedade é de 280 caracteres. -
As propriedades
contentDetails.startAtecontentDetails.endAtdo recursoplaylistItemforam descontinuadas. Esses campos serão ignorados se forem definidos em solicitaçõesplaylistItems.insertouplaylistItems.update. -
Os métodos
playlistItems.deleteeplaylistItems.updateagora aceitam o parâmetroonBehalfOfContentOwner, que já é aceito por vários outros métodos. As solicitações que usam esse método também precisam ser autorizadas com um token que forneça acesso ao escopohttps://www.googleapis.com/auth/youtubepartner. -
Os parâmetros
publishedBeforeepublishedAfterdo métodosearch.listforam atualizados para indicar que os valores de parâmetro são inclusivos. Por exemplo, se o parâmetropublishedBeforeestiver definido, a API vai retornar recursos criados até o horário especificado. -
A propriedade
contentDetails.contentRating.grfilmRatingdo recursovideoaceita mais três valores:grfilmK12,grfilmK15egrfilmK18. -
A descrição do método
videos.insertfoi atualizada para indicar que o tamanho máximo de arquivo para vídeos enviados aumentou de 64 GB para 128 GB.
-
-
Erros novos e atualizados
-
A API é compatível com os seguintes novos erros:
Tipo de erro Detalhe do erro Descrição forbidden (403)homeParameterDeprecatedO método activities.listretorna esse erro para indicar que os dados de atividade da página inicial do usuário não estão disponíveis por essa API. Esse erro pode ocorrer se você definir o parâmetrohomecomotrueem uma solicitação não autorizada.invalidValue (400)invalidContentDetailsO método playlistItems.insertretorna esse erro para indicar que o objetocontentDetailsna solicitação é inválido. Um motivo para esse erro é que o campocontentDetails.notetem mais de 280 caracteres.forbidden (403)watchHistoryNotAccessibleO método playlistItems.listretorna esse erro para indicar que a solicitação tentou recuperar itens da playlist "Histórico de exibição", mas eles não podem ser recuperados usando a API.forbidden (403)watchLaterNotAccessibleO método playlistItems.listretorna esse erro para indicar que a solicitação tentou recuperar itens da playlist "Assistir mais tarde", mas eles não podem ser recuperados usando a API.badRequest (400)uploadLimitExceededO método videos.insertretorna esse erro para indicar que o canal excedeu o número de vídeos que pode enviar.forbidden (403)forbiddenEmbedSettingO método videos.updateretorna esse erro para indicar que a solicitação de API tenta definir uma configuração de incorporação inválida para o vídeo. Alguns canais podem não ter permissão para oferecer players incorporados em transmissões ao vivo. Veja mais informações na Central de Ajuda do YouTube. -
O método
playlistItems.insertnão retorna mais um erro se você inserir um vídeo duplicado em uma playlist. Esse erro ocorria em algumas playlists, como as de vídeos favoritos, que não permitiam duplicatas, mas não são mais compatíveis. Em geral, as playlists permitem vídeos duplicados.
-
-
Outras atualizações
-
A entrada do histórico de revisões de 15 de setembro de 2016 foi atualizada para esclarecer que, sempre que as propriedades
contentDetails.relatedPlaylists.watchHistoryecontentDetails.relatedPlaylists.watchLaterdo recursochannelforem incluídas em uma resposta, elas sempre vão conter os valoresHLeWL, respectivamente. Além disso, essas propriedades só serão incluídas se um usuário autorizado estiver recuperando dados sobre o próprio canal.
-
15 de setembro de 2016
Esta atualização contém as seguintes alterações:
A atualização do histórico de revisões de 11 de agosto de 2016 abordou várias mudanças relacionadas aos IDs de tópicos, incluindo o fato de que o conjunto de IDs de tópicos compatíveis vai mudar a partir de 10 de fevereiro de 2017. A lista de tópicos que serão aceitos será publicada até 10 de novembro de 2016.
As seguintes mudanças já estão em vigor. O aviso sobre essas mudanças foi dado na atualização do histórico de revisões em 11 de agosto de 2016:
- Se o método
activities.listfor chamado com o parâmetrohomedefinido comotrue, a resposta da API vai conter itens semelhantes ao que um usuário desconectado do YouTube veria na página inicial.
Essa é uma pequena mudança que visa proporcionar uma experiência do usuário melhor do que o comportamento descrito na atualização do histórico de revisões em 11 de agosto de 2016. Essa atualização informava que as solicitações que usavam o parâmetro
homeretornariam uma lista vazia.- As propriedades
contentDetails.relatedPlaylists.watchHistoryecontentDetails.relatedPlaylists.watchLaterdo recursochannelagora contêm valores deHLeWL, respectivamente, para todos os canais.
Para esclarecer, essas propriedades só ficam visíveis para um usuário autorizado que recupera dados sobre o próprio canal. As propriedades sempre contêm os valores
HLeWL, mesmo para um usuário autorizado que recupera dados sobre o próprio canal. Portanto, os IDs do histórico de exibição e o código da playlist "Assistir mais tarde" não podem ser recuperados usando a API.Além disso, as solicitações para recuperar detalhes de playlists (
playlists.list) ou itens de playlists (playlistItems.list) do histórico de exibição ou da playlist "Assistir mais tarde" de um canal agora retornam listas vazias. Esse comportamento é válido para os novos valores,HLeWL, e para qualquer código da playlist do histórico de exibição ou de assistir mais tarde que seu cliente de API já tenha armazenado.- Se o método
O objeto
fileDetails.recordingLocationdo recursovideoe as propriedades filhas dele não são mais retornados. Antes, esses dados (como o objeto paifileDetails) só podiam ser recuperados pelo proprietário de um vídeo.
11 de agosto de 2016
Esta atualização contém as seguintes alterações:
Os Termos de Serviço dos serviços de APIs do YouTube recém-publicados ("Termos Atualizados"), discutidos em detalhes no Blog de engenharia e desenvolvedores do YouTube, oferecem um conjunto avançado de atualizações para os Termos de Serviço atuais. Além dos Termos atualizados, que entrarão em vigor em 10 de fevereiro de 2017, essa atualização inclui vários documentos de suporte para ajudar a explicar as políticas que os desenvolvedores precisam seguir.
O conjunto completo de novos documentos está descrito no histórico de revisões dos Termos Atualizados. Além disso, as mudanças futuras nos Termos Atualizados ou nos documentos de suporte também serão explicadas nesse histórico de revisões.
A descontinuação do Freebase e da API Freebase está causando várias mudanças relacionadas aos IDs de tópicos. Os IDs de tópicos são usados nos seguintes recursos e métodos de API:
- A parte
topicDetailsdo recursochannelidentifica os tópicos associados ao canal. - A parte
topicDetailsdo recursovideoidentifica os tópicos associados ao vídeo. - O parâmetro
topicIddo métodosearch.listpermite pesquisar vídeos ou canais relacionados a um determinado tópico.
As mudanças nesses recursos são:
- A partir de 10 de fevereiro de 2017, o YouTube vai começar a retornar um pequeno conjunto de IDs de tópicos em vez do conjunto muito mais granular de IDs retornados até o momento. Esse conjunto de tópicos compatíveis vai identificar categorizações de alto nível, como Esportes ou Basquete, mas, por exemplo, não vai identificar times ou jogadores específicos. Vamos anunciar o conjunto de temas compatíveis para que você tenha tempo de preparar seu aplicativo para essa mudança.
- Todos os IDs de tópicos do Freebase que você já recuperou podem ser usados para pesquisar conteúdo até 10 de fevereiro de 2017. No entanto, após esse período, você só poderá usar o conjunto menor de tópicos identificados no item anterior para recuperar resultados da pesquisa por tópico.
- Após 10 de fevereiro de 2017, se você tentar pesquisar resultados usando um ID de tópico que não esteja no conjunto menor de IDs de tópicos compatíveis, a API retornará um conjunto de resultados vazio.
- A parte
Vários campos e parâmetros de API serão descontinuados a partir de 12 de setembro de 2016:
O parâmetro
homedo métodoactivities.listpermitia que um usuário autorizado recuperasse o feed de atividades que seria exibido na página inicial do YouTube para esse usuário. As solicitações que usarem esse parâmetro após 12 de setembro de 2016 vão retornar uma lista vazia.As propriedades
contentDetails.relatedPlaylists.watchHistoryecontentDetails.relatedPlaylists.watchLaterdo recursochannelsó ficam visíveis para um usuário autorizado que está recuperando dados sobre o próprio canal. Depois de 12 de setembro de 2016,contentDetails.relatedPlaylists.watchHistoryretornará um valor deHL, e a propriedadecontentDetails.relatedPlaylists.watchLaterretornará um valor deWLpara todos os canais.
As solicitações para recuperar detalhes da playlist (
playlists.list) do histórico de exibição ou da playlist "Assistir mais tarde" de um canal vão retornar uma lista vazia após 12 de setembro de 2016. As solicitações para recuperar itens de playlist (playlistItems.list) em qualquer uma dessas playlists também vão retornar uma lista vazia após esse período. Isso é válido para os novos valores,HLeWL, bem como para qualquer código da playlist do histórico de exibição ou de assistir mais tarde que seu cliente de API já tenha armazenado.- O objeto
fileDetails.recordingLocationdo recursovideoou qualquer uma das propriedades filhas dele não serão mais retornados após 12 de setembro de 2016. Esses dados só podem ser recuperados pelo proprietário de um vídeo, já que o objeto paifileDetailssó pode ser recuperado por um proprietário de vídeo.
13 de junho de 2016
Esta atualização contém as seguintes alterações:
- A propriedade
contentDetails.googlePlusUserIddo recursochannelfoi descontinuada. Antes, a propriedade só estava presente se o canal estivesse associado a um perfil do Google+. Após a descontinuação, a propriedade não será mais incluída em nenhum recursochannel. - A propriedade
snippet.authorGoogleplusProfileUrldo recursocommentfoi descontinuada. Antes, a propriedade só estava presente se o canal estivesse associado a um perfil do Google+. Após a descontinuação, a propriedade não será mais incluída em nenhum recursocomment.
Como nenhuma dessas propriedades será retornada após a descontinuação, ambas foram removidas da documentação do recurso correspondente.
31 de maio de 2016
Esta atualização contém as seguintes alterações:
O novo parâmetro
myRecentSubscribersdo métodosubscriptions.listrecupera uma lista dos inscritos do canal do usuário autenticado em ordem cronológica inversa do momento em que se inscreveram no canal.O novo parâmetro só permite recuperar os 1.000 inscritos mais recentes no canal do usuário autenticado. Para recuperar uma lista completa de assinantes, use o parâmetro
mySubscribers. Esse parâmetro, que não retorna inscritos em uma ordem específica, não limita o número de inscritos que podem ser recuperados.A definição da propriedade
snippet.thumbnails.(key)foi atualizada para os recursos activity, playlistItem, playlist, resultado da pesquisa, thumbnail e video para indicar que tamanhos adicionais de imagem de miniatura estão disponíveis para alguns vídeos.- A imagem
standardtem 640 px de largura e 480 px de altura. - A imagem
maxrestem 1.280 px de largura e 720 px de altura.
- A imagem
A definição do parâmetro
partdo métodochannelSection.listfoi atualizada para indicar que a partetargetingpode ser recuperada ao custo de2unidades de cota.O método
videos.listagora retorna um erro proibido (403) quando uma solicitação autorizada incorretamente tenta recuperar as partesfileDetails,processingDetailsousuggestionsde um recursovideo. Essas partes estão disponíveis apenas para o proprietário do vídeo.
17 de maio de 2016
A nova ferramenta Snippets de código da API Data oferece snippets de código curtos para casos de uso comuns da API YouTube Data. Os snippets de código estão disponíveis para todos os métodos de API somente leitura no Apps Script, Go, JavaScript, PHP, Python e Ruby.
Para cada método, a ferramenta mostra exemplos de código para um ou mais casos de uso. Por
exemplo, ele fornece cinco snippets de código para o método search.list:
- Listar vídeos por palavra-chave
- Listar vídeos por local
- Listar eventos ao vivo
- Pesquisar os vídeos do usuário autenticado
- Listar vídeos relacionados
Para cada caso de uso, a ferramenta mostra os parâmetros usados na solicitação de API. É possível modificar os valores de parâmetro. Nesse caso, a ferramenta atualiza os snippets de código para refletir os valores de parâmetro fornecidos.
Por fim, a ferramenta exibe a resposta da API para cada solicitação. Se você tiver modificado os parâmetros de solicitação, a resposta da API será baseada nos valores de parâmetro fornecidos. É necessário autorizar a ferramenta a enviar solicitações em seu nome para que as respostas da API sejam exibidas.
28 de abril de 2016
Esta atualização contém as seguintes alterações:
A nova propriedade
contentDetails.projectiondo recursovideoespecifica o formato de projeção do vídeo. Os valores de propriedade válidos são360erectangular.As propriedades
recordingDetails.locationefileDetails.recordingLocationdo recursovideoforam atualizadas para explicar a diferença entre as duas propriedades:- A propriedade
recordingDetails.locationidentifica o local que o proprietário do vídeo quer associar ao vídeo. Esse local é editável, pesquisável em vídeos públicos e pode ser exibido aos usuários em vídeos públicos. - O valor da propriedade
fileDetails.recordingLocationé imutável e representa o local associado ao arquivo de vídeo original enviado. O valor só fica visível para o proprietário do vídeo.
- A propriedade
A definição da propriedade
contentDetails.relatedPlaylists.favoritesdo recursochannelfoi atualizada para indicar que o valor da propriedade pode conter um código da playlist que se refere a uma playlist vazia e que não pode ser buscada. Isso ocorre porque a funcionalidade de vídeos favoritos já foi descontinuada. Essa propriedade não está sujeita à política de descontinuação da API.A definição do erro
ineligibleAccount, que pode ser retornado pelo métodocomments.insert,comments.update,commentThreads.insertoucommentThreads.update, foi atualizada para refletir que o erro ocorre quando a conta do YouTube usada para autorizar a solicitação de API não foi mesclada com a Conta do Google do usuário.
20 de abril de 2016
Esta atualização contém as seguintes alterações:
- A definição do parâmetro
partdo métodochannels.updatefoi atualizada para observar quelocalizationstambém é um valor válido para esse parâmetro. - A seção Uso de cota do guia de iniciação foi atualizada para vincular ao Console do Google Developers, onde é possível ver sua cota real e o uso dela.
16 de março de 2016
Esta atualização contém as seguintes alterações:
-
Atualizações de recursos e métodos atuais
-
A documentação do recurso
channelBannerfoi atualizada para indicar que o tamanho recomendado para a imagem do banner do canal é de 2560 px por 1440 px. O tamanho mínimo (2048 x 1152 pixels) não mudou. -
A nova propriedade
snippet.customUrldo recursochannelidentifica o URL personalizado associado ao canal. Nem todos os canais têm URLs personalizados. A Central de Ajuda do YouTube explica os requisitos de qualificação para receber um URL personalizado e como configurá-lo. -
O objeto
brandingSettings.watchdo recursochannele todas as propriedades filhas dele foram descontinuados. -
A resposta da API a uma solicitação
search.listagora contém uma propriedaderegionCode. A propriedade identifica o código da região usado para a consulta de pesquisa. O código de região instrui a API a retornar resultados da pesquisa para o país especificado.O valor da propriedade é um código de país ISO de duas letras que identifica a região. O método
i18nRegions.listretorna uma lista de regiões com disponibilidade. O valor padrão éUS. Se uma região com disponibilidade não for especificada, o YouTube ainda poderá selecionar outra região, em vez do valor padrão, para processar a consulta. -
As definições das propriedades
snippet.labelesnippet.secondaryReasons[].labeldo recursovideoAbuseReportReasonforam atualizadas para indicar que as propriedades contêm texto de rótulo localizado para os motivos da denúncia de abuso.Além disso, o método
videoAbuseReportReasons.listagora é compatível com o parâmetrohl, que especifica o idioma que deve ser usado para o texto do rótulo na resposta da API. O valor de parâmetro padrão éen_US. -
A nova propriedade
contentDetails.contentRating.ecbmctRatingdo recursovideoidentifica a classificação de um vídeo de acordo com o Conselho de Avaliação e Classificação do Ministério da Cultura e Turismo da Turquia.Além disso, as propriedades da API para outros sistemas de classificação aceitam os seguintes novos valores de propriedade:
contentDetails.contentRating.fpbRating(África do Sul)
Classificação: 10; valor da propriedade:fpb10contentDetails.contentRating.moctwRating(Taiwan)
Classificação: R-12; valor da propriedade:moctwR12contentDetails.contentRating.moctwRating(Taiwan)
Classificação: R-15; valor da propriedade:moctwR15
-
A propriedade
liveStreamingDetails.activeLiveChatIddo recursovideocontém o ID do chat ao vivo ativo associado ao vídeo. O valor da propriedade só estará presente se o vídeo for uma transmissão ao vivo atual com o chat ao vivo ativado. Depois que a transmissão termina e o chat ao vivo é concluído, a propriedade não é mais retornada para o vídeo. -
A propriedade
status.rejectionReasondo recursovideoé compatível com o novo valor de propriedadelegal.
-
-
A API é compatível com os seguintes novos erros:
Tipo de erro Detalhe do erro Descrição badRequest (400)notEditableOs métodos channelSections.insert,channelSections.updateechannelSections.deleteretornam esse erro para indicar que a seção do canal especificada não pode ser criada, atualizada ou excluída.badRequest (400)styleRequiredOs métodos channelSections.insertechannelSections.updateretornam esse erro para indicar que o recursochannelSectionenviado na solicitação de API precisa especificar um valor para a propriedadesnippet.style.badRequest (400)typeRequiredOs métodos channelSections.insertechannelSections.updateretornam esse erro para indicar que o recursochannelSectionenviado na solicitação de API precisa especificar um valor para a propriedadesnippet.type.badRequest (400)processingFailureO método commentThreads.listretorna esse erro para indicar que o servidor de API não conseguiu processar a solicitação. Embora possa ser um erro temporário, geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recursocommentThreadno corpo da solicitação para garantir que ele seja válido.forbidden (403)commentsDisabledO método commentThreads.listretorna esse erro para indicar que o vídeo identificado pelo parâmetrovideoIddesativou os comentários.badRequest (400)commentTextTooLongO método commentThreads.insertretorna esse erro para indicar que o recursocommentque está sendo inserido contém muitos caracteres na propriedadesnippet.topLevelComment.snippet.textOriginal.invalidValue (400)videoAlreadyInAnotherSeriesPlaylistO método playlistItems.insertretorna esse erro para indicar que o vídeo que você está tentando adicionar à playlist já está em outra playlist em série. Acesse a Central de Ajuda do YouTube para mais informações sobre as playlists em série.badRequest (400)subscriptionForbiddenO método subscriptions.insertretorna esse erro para indicar que você atingiu o número máximo de inscrições ou que criou muitas inscrições recentemente. Nesse caso, tente novamente após algumas horas.badRequest (400)invalidCategoryIdO método videos.updateretorna esse erro para indicar que a propriedadesnippet.categoryIdno recursovideoenviado especificou um ID de categoria inválido. Use o métodovideoCategories.listpara recuperar as categorias compatíveis.badRequest (400)invalidDescriptionO método videos.updateretorna esse erro para indicar que a propriedadesnippet.descriptionno recursovideoenviado especificou um valor inválido.badRequest (400)invalidPublishAtO método videos.updateretorna esse erro para indicar que a propriedadestatus.publishAtno recursovideoenviado especificou um horário de publicação programada inválido.badRequest (400)invalidRecordingDetailsO método videos.updateretorna esse erro para indicar que o objetorecordingDetailsno recursovideoenviado especificou detalhes de gravação inválidos.badRequest (400)invalidTagsO método videos.updateretorna esse erro para indicar que a propriedadesnippet.tagsno recursovideoenviado especificou um valor inválido.badRequest (400)invalidTitleO método videos.updateretorna esse erro para indicar que a propriedadesnippet.titleno recursovideoenviado especificou um título de vídeo inválido ou vazio.badRequest (400)invalidVideoMetadataO método videos.updateretorna esse erro para indicar que os metadados da solicitação são inválidos. Esse erro ocorre se a solicitação atualiza a partesnippetde um recursovideo, mas não define um valor para as propriedadessnippet.titleesnippet.categoryId.
18 de dezembro de 2015
As leis da União Europeia (UE) exigem que determinadas divulgações sejam feitas e consentimentos sejam obtidos dos usuários finais na UE. Portanto, para usuários finais na União Europeia, é preciso obedecer à Política de consentimento de usuários da União Europeia. Adicionamos um aviso sobre esse requisito nos Termos de Serviço da API YouTube.
19 de novembro de 2015
A API agora permite definir e recuperar texto localizado para as propriedades snippet.title e snippet.description dos recursos playlist e video, a propriedade snippet.title do recurso channelSection e a propriedade snippet.description do recurso channel.
-
Como definir títulos e descrições localizados
É possível definir valores localizados para um recurso ao chamar o método
insertouupdatedele. Para definir valores localizados para um recurso, faça o seguinte:-
Verifique se um valor está definido para a propriedade
snippet.defaultLanguagedo recurso. Essa propriedade identifica o idioma das propriedadessnippet.titleesnippet.descriptiondo recurso. O valor pode ser qualquer idioma de aplicativo compatível ou a maioria dos outros códigos de idioma ISO 639-1:2002. Por exemplo, se você enviar um vídeo com título e descrição em inglês, defina a propriedadesnippet.defaultLanguagecomoen.Observação para atualizar recursos
channel: para definir a propriedadesnippet.defaultLanguagede um recursochannel, é necessário atualizar a propriedadebrandingSettings.channel.defaultLanguage. -
Adicione o objeto
localizationsao recurso que você está atualizando. Cada chave de objeto é uma string que identifica um idioma do aplicativo ou um código de idioma ISO 639-1:2002, e cada chave é mapeada para um objeto que contém o título (e a descrição) localizado do recurso.O snippet de exemplo abaixo define o idioma padrão do recurso como inglês. Ele também adiciona títulos e descrições localizados em alemão e espanhol a um vídeo:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
Importante: ao atualizar os dados localizados de um recurso, sua solicitação de API precisa incluir todas as versões localizadas atuais dos dados. Por exemplo, se você enviar uma solicitação para adicionar dados em português ao vídeo do exemplo acima, ela precisará incluir os dados localizados em alemão, espanhol e português.
-
-
Como recuperar valores localizados
A API oferece duas maneiras de recuperar valores localizados para um recurso:
-
Adicione o parâmetro
hlà sua solicitaçãochannels.list,channelSections.list,playlists.listouvideos.listpara recuperar dados localizados de um idioma de aplicativo específico compatível com o site do YouTube. Se os detalhes do recurso localizado estiverem disponíveis nesse idioma, o objetosnippet.localizeddo recurso vai conter os valores localizados. No entanto, se os detalhes localizados não estiverem disponíveis, o objetosnippet.localizedvai conter detalhes no idioma padrão do recurso.Por exemplo, suponha que uma solicitação
videos.listtenha recuperado dados do vídeo descrito acima com dados localizados em alemão e espanhol. Se o parâmetrohlfosse definido comode, o recurso conteria os seguintes dados:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }No entanto, se o parâmetro
hlfosse definido comofr, o objetosnippet.localizedconteria o título e a descrição em inglês, porque esse é o idioma padrão do recurso, e os detalhes localizados em francês não estão disponíveis.Importante: o parâmetrohlsó aceita valores que identificam idiomas de aplicativos compatíveis com o site do YouTube. Para determinar se o texto localizado está disponível para outros idiomas, é necessário recuperar a partelocalizationsdo recurso e filtrar para determinar se o texto localizado existe.
Por exemplo, você precisaria recuperar a lista completa de localizações para determinar se o texto localizado está disponível em inglês dos Apalaches.
-
Ao recuperar um recurso, inclua
localizationsno valor do parâmetropartpara recuperar todos os detalhes localizados desse recurso. Se você estiver recuperando dados localizados para um idioma que não é um idioma atual do aplicativo do YouTube, use essa abordagem para recuperar todas as localizações e, em seguida, filtre para determinar se os dados localizados desejados existem.
-
-
Erros relacionados a valores de texto localizados
A API também é compatível com os seguintes novos erros para valores de texto localizados:
Tipo de erro Detalhe do erro Descrição badRequest (400)defaultLanguageNotSetErrorEsse erro indica que uma solicitação que tenta inserir ou atualizar o objeto localizationsde um recurso está falhando porque a propriedadesnippet.defaultLanguagenão está definida para esse recurso. Os métodoschannels.update,channelSections.insert,channelSections.update,playlists.insert,playlists.update,videos.insertevideos.updatesão compatíveis com esse erro.badRequest (400)localizationValidationErrorEsse erro indica que um dos valores no objeto localizationsde um recurso não foi validado. Por exemplo, esse erro pode ocorrer se o objeto tiver um código de idioma inválido. Os métodoschannels.update,channelSections.insert,channelSections.update,playlists.inserteplaylists.updatesão compatíveis com esse erro.
4 de novembro de 2015
Esta atualização contém as seguintes alterações:
-
Atualizações de recursos e métodos atuais
-
O parâmetro
orderdo métodosearch.listfoi atualizado para indicar que, se você ordenar as transmissões ao vivo porviewCount, os resultados da API serão ordenados pelo número de espectadores simultâneos enquanto as transmissões ainda estiverem em andamento. -
O parâmetro
relatedToVideoIddo métodosearch.listfoi atualizado para indicar que, se o parâmetro estiver definido, os únicos outros parâmetros compatíveis serãopart,maxResults,pageToken,regionCode,relevanceLanguage,safeSearch,type(que precisa ser definido comovideo) efields. Essa atualização não reflete uma mudança no comportamento da API. -
A definição da propriedade
snippet.publishedAtdo recursovideofoi atualizada para indicar que o valor da propriedade, que especifica a data e a hora em que o vídeo foi publicado, pode ser diferente do horário em que o vídeo foi enviado. Por exemplo, se um vídeo for enviado como privado e depois se tornar público, o valor da propriedade especificará o momento em que o vídeo se tornou público. A definição atualizada também explica como o valor é preenchido para vídeos privados e não listados.Essa mudança não reflete uma alteração no comportamento da API.
-
A definição da propriedade
status.publishAtdo recursovideofoi atualizada para observar:- Se você definir o valor dessa propriedade ao chamar o método
videos.update, também precisará definir o valor da propriedadestatus.privacyStatuscomoprivate, mesmo que o vídeo já seja privado. - Se a solicitação programar um vídeo para ser publicado em um momento no passado, ele será publicado imediatamente. Assim, o efeito de definir a propriedade
status.publishAtcomo uma data e hora anteriores é o mesmo que mudar oprivacyStatusdo vídeo deprivateparapublic.
- Se você definir o valor dessa propriedade ao chamar o método
-
A propriedade
contentDetails.contentRating.cncRatingdo recursovideoespecifica a classificação do vídeo de acordo com a Commission de classification cinematographique da França. Essa propriedade substitui a propriedadecontentDetails.contentRating.fmocRating, que foi descontinuada. -
A definição de
brandingSettings.channel.keywordsdo recursochannelfoi atualizada para refletir corretamente que o valor da propriedade contém uma lista de strings separada por espaços, e não uma lista separada por vírgulas, como documentado anteriormente. Essa atualização não reflete uma mudança no comportamento da API. -
A documentação do método
thumbnails.setfoi atualizada para refletir com precisão que o corpo da solicitação contém a imagem da miniatura que você está enviando e associando a um vídeo. O corpo da solicitação não contém um recursothumbnail. Anteriormente, a documentação dizia que não era necessário fornecer um corpo de solicitação ao chamar esse método. Essa atualização não reflete uma mudança no comportamento da API. -
A descrição do recurso
activityfoi atualizada para refletir o fato de que o métodoactivities.listnão inclui recursos relacionados a novos comentários de vídeo. Osnippet.typee ocontentDetails.commentdo recurso também foram atualizados.
-
-
Erros novos e atualizados
-
A API agora é compatível com os seguintes erros:
Detalhes do erro activities.insertCódigo de resposta HTTP badRequest (400)Motivo invalidMetadataDescrição A propriedade kindnão corresponde ao tipo de ID fornecido.commentThreads.updatecomments.insertcomments.updateCódigo de resposta HTTP badRequest (400)Motivo commentTextTooLongDescrição O recurso commentque está sendo inserido ou atualizado contém muitos caracteres na propriedadesnippet.topLevelComment.snippet.textOriginal.playlistItems.insertplaylistItems.updateCódigo de resposta HTTP forbidden (403)Motivo playlistItemsNotAccessibleDescrição A solicitação não está devidamente autorizada para inserir, atualizar ou excluir o item de playlist especificado. playlists.deleteplaylists.insertplaylists.updateCódigo de resposta HTTP badRequest (400)Motivo playlistForbiddenDescrição A operação é proibida ou a solicitação não está devidamente autorizada. search.listCódigo de resposta HTTP badRequest (400)Motivo invalidLocationDescrição O valor do parâmetro locatione/oulocationRadiusfoi formatado incorretamente.search.listCódigo de resposta HTTP badRequest (400)Motivo invalidRelevanceLanguageDescrição O valor do parâmetro relevanceLanguagefoi formatado incorretamente.subscriptions.insertCódigo de resposta HTTP badRequest (400)Motivo subscriptionForbiddenDescrição Esse erro ocorre quando qualquer uma das seguintes condições é verdadeira: - A assinatura que você está tentando criar já existe
- Você já atingiu o número máximo de assinaturas
- Você está tentando se inscrever no seu próprio canal, o que não é possível.
- Você criou muitas assinaturas recentemente e precisa aguardar algumas horas antes de tentar novamente.
videos.updateCódigo de resposta HTTP badRequest (400)Motivo invalidDefaultBroadcastPrivacySettingDescrição A solicitação tenta definir uma configuração de privacidade inválida para a transmissão padrão.
-
28 de agosto de 2015
Esta atualização contém as seguintes alterações:
Atualizações de recursos e métodos atuais
- A propriedade
statistics.favoriteCountdo recursovideofoi descontinuada.
De acordo com nossa política de descontinuação, essa propriedade continuará sendo incluída nos recursos
videopor pelo menos um ano após este anúncio. No entanto, o valor da propriedade agora é sempre definido como0.- A propriedade
7 de agosto de 2015
Esta atualização contém as seguintes alterações:
Atualizações de recursos e métodos atuais
- A definição da propriedade
snippet.tags[]do recursovideofoi atualizada para fornecer mais informações sobre como o servidor da API calcula o tamanho do valor da propriedade. Essa atualização não reflete uma mudança no comportamento da API.
Especificamente, a definição agora explica que, se uma tag tiver um espaço, o servidor de API vai processar o valor da tag como se estivesse entre aspas, e as aspas vão contar para o limite de caracteres. Portanto, para fins de limites de caracteres, a tag
Foo-Bazcontém sete caracteres, mas a tagFoo Bazcontém nove caracteres.- O método
commentThreads.insertnão é mais compatível com o parâmetroshareOnGooglePlus, que antes indicava se um comentário e as respostas a ele também deveriam ser postados no perfil do Google+ do autor. Se uma solicitação enviar o parâmetro, o servidor de API vai ignorá-lo, mas vai processar a solicitação.
- A definição da propriedade
18 de junho de 2015
Esta atualização contém as seguintes alterações:
-
Atualizações de recursos e métodos atuais
-
O novo parâmetro
orderdo métodocommentThreads.listespecifica a ordem em que a resposta da API deve listar as conversas. As conversas podem ser ordenadas por horário ou relevância. O comportamento padrão é ordená-los por horário. -
A nova propriedade
snippet.defaultAudioLanguagedo recursovideoespecifica o idioma falado na faixa de áudio padrão do vídeo. -
A definição da propriedade
contentDetails.licensedContentdo recursovideofoi atualizada para esclarecer que o conteúdo precisa ter sido enviado originalmente para um canal vinculado a um parceiro de conteúdo do YouTube e, em seguida, reivindicado por esse parceiro. Isso não representa uma mudança no comportamento real da API. -
Os métodos
captions.delete,captions.download,captions.insert,captions.listecaptions.updateagora aceitam o parâmetroonBehalfOfContentOwner, que já é compatível com vários outros métodos. As solicitações que usam esse método também precisam ser autorizadas com um token que forneça acesso ao escopohttps://www.googleapis.com/auth/youtubepartner.
-
-
Erros novos e atualizados
-
A API agora é compatível com os seguintes erros:
Detalhes do erro videos.rateCódigo de resposta HTTP badRequest (400)Motivo emailNotVerifiedDescrição O usuário precisa verificar o endereço de e-mail antes de classificar o vídeo. videos.rateCódigo de resposta HTTP badRequest (400)Motivo videoPurchaseRequiredDescrição Os vídeos alugados só podem ser avaliados por usuários que os alugaram. -
Os métodos
subscriptions.deleteesubscriptions.insertnão são mais compatíveis com os errosaccountClosedeaccountSuspended.
-
27 de abril de 2015
Esta atualização contém as seguintes alterações:
-
Novos recursos e métodos
-
O novo recurso
videoAbuseReportReasoncontém informações sobre o motivo pelo qual um vídeo foi sinalizado por conteúdo abusivo. O métodovideoAbuseReportReasons.listpermite recuperar uma lista de todos os motivos pelos quais os vídeos podem ser sinalizados. -
O novo método
videos.reportAbusepermite sinalizar um vídeo que contém conteúdo abusivo. O corpo da solicitação contém um objeto JSON que especifica o vídeo que está sendo sinalizado, bem como o motivo pelo qual o vídeo é considerado como contendo conteúdo abusivo. Os motivos válidos podem ser obtidos no métodovideoAbuseReportReason.listdescrito acima.O guia de migração também foi atualizado com um exemplo de como denunciar um vídeo abusivo. Com essa mudança, a API v3 agora é compatível com todos os recursos da API v2 que estão programados para serem compatíveis. Todos esses recursos também são explicados no guia de migração.
-
-
Atualizações de recursos e métodos atuais
-
O novo parâmetro de filtro
forDeveloperdo métodosearch.listrestringe uma pesquisa para recuperar apenas vídeos enviados pelo aplicativo ou site do desenvolvedor. O parâmetroforDeveloperpode ser usado com parâmetros de pesquisa opcionais, comoq.Para esse recurso, cada vídeo enviado é marcado automaticamente com o número do projeto associado ao aplicativo do desenvolvedor no Google Developers Console.
Quando uma solicitação de pesquisa define o parâmetro
forDevelopercomotrue, o servidor de API usa as credenciais de autorização da solicitação para identificar o desenvolvedor. Portanto, um desenvolvedor pode restringir os resultados aos vídeos enviados pelo próprio app ou site, mas não aos vídeos enviados por outros apps ou sites.O novo recurso oferece uma funcionalidade semelhante, mas não idêntica, à das tags de desenvolvedor que a API v2 aceitava.
-
A nova propriedade
snippet.countrydo recursochannelpermite que os proprietários de canais associem os canais a um país específico.Observação: para definir a propriedade
snippet.countryde um recursochannel, é preciso atualizar a propriedadebrandingSettings.channel.country. -
A API agora é compatível com a segmentação de recursos
channelSection. A segmentação por seção do canal é uma forma de restringir a visibilidade de uma seção de conteúdo aos usuários que atendem a determinados critérios.A API expõe três opções de segmentação. Um usuário precisa atender a todas as configurações de segmentação para que uma seção do canal fique visível.
-
targeting.languages[]: uma lista de idiomas do aplicativo do YouTube. Os usuários que escolheram um desses idiomas podem ver a seção correspondente do canal. -
targeting.regions[]: uma lista de regiões de conteúdo do YouTube Preferred. A seção do canal fica visível para os usuários que selecionaram uma dessas regiões, bem como para os usuários que têm uma dessas regiões selecionada automaticamente. -
targeting.countries[]: uma lista de países em que a seção do canal está visível. Cada valor na lista é um código de país ISO 3166-1 alfa-2.
-
-
A definição da propriedade
contentDetails.durationdo recursovideofoi corrigida para refletir que o valor pode refletir horas, dias etc. -
A documentação dos métodos
channelSections.delete,playlistItems.delete,playlists.delete,subscriptions.deleteevideos.deletefoi corrigida para refletir que, quando bem-sucedidos, todos esses métodos retornam um código de resposta HTTP204(No Content).
-
-
Erros novos e atualizados
-
A API agora é compatível com os seguintes erros:
Tipo de erro Detalhe do erro Descrição badRequest (400)targetInvalidCountryOs métodos channelSections.insertechannelSections.updatevão retornar esse erro se o recursochannelSectioninserido tiver um valor inválido para a propriedadetargeting.countries[].badRequest (400)targetInvalidLanguageOs métodos channelSections.insertechannelSections.updatevão retornar esse erro se o recursochannelSectioninserido tiver um valor inválido para a propriedadetargeting.languages[].badRequest (400)targetInvalidRegionOs métodos channelSections.insertechannelSections.updatevão retornar esse erro se o recursochannelSectioninserido tiver um valor inválido para a propriedadetargeting.regions[].badRequest (400)operationNotSupportedO método comments.insertretorna esse erro se o usuário da API não puder inserir um comentário em resposta ao comentário de nível superior identificado pela propriedadesnippet.parentId. Em um recursocommentThread, a propriedadesnippet.canReplyindica se o espectador atual pode responder à conversa.badRequest (400)invalidChannelIdO método search.listvai retornar esse erro se o parâmetrochannelIdna solicitação especificar um ID de canal inválido.badRequest (400)subscriptionForbiddenO método subscriptions.insertretorna esse erro se o usuário da API tentar se inscrever no próprio canal. -
O método
captions.updatenão é mais compatível com os errosinvalidMetadataevideoNotFound.
-
16 de abril de 2015
Esta atualização contém as seguintes alterações:
O guia de migração foi atualizado para explicar como migrar aplicativos que ainda usam a funcionalidade de comentários da API v2.
O guia também destaca vários recursos de comentários que não eram compatíveis com a API v2, mas que são compatíveis com a API v3. Veja alguns exemplos:
- Como recuperar comentários sobre um canal
- Recuperar todas as conversas relacionadas a um canal, o que significa que a resposta da API pode conter comentários sobre o canal ou qualquer um dos vídeos dele.
- Atualizar o texto de um comentário
- Marcar um comentário como spam
- Como definir o status de moderação de um comentário
O guia Como se inscrever para receber notificações push foi atualizado para refletir o fato de que as notificações são enviadas apenas para o hub do Google PubSubHubBub, e não para o hub do Superfeedr, como indicado anteriormente.
9 de abril de 2015
Esta atualização contém as seguintes alterações:
-
Os novos recursos
commentThreadecommentda API permitem recuperar, inserir, atualizar, excluir e moderar comentários.-
Um recurso
commentThreadcontém informações sobre uma conversa do YouTube, que inclui um comentário de nível superior e as respostas a ele, se houver. Um recursocommentThreadpode representar comentários sobre um vídeo ou um canal.O comentário de nível superior e as respostas são, na verdade, recursos
commentaninhados no recursocommentThread. É importante observar que o recursocommentThreadnão contém necessariamente todas as respostas a um comentário, e você precisa usar o métodocomments.listse quiser recuperar todas as respostas de um comentário específico. Além disso, alguns comentários não têm respostas.A API é compatível com os seguintes métodos para recursos
commentThread:commentThreads.list: recupera uma lista de sequências de comentários. Use esse método para recuperar comentários associados a um vídeo ou canal específico.commentThreads.insert: cria um novo comentário de nível superior. Use o métodocomments.insertpara responder a um comentário.commentThreads.update: modifica um comentário de nível superior.
-
Um recurso
commentcontém informações sobre um único comentário do YouTube. Um recursocommentpode representar um comentário sobre um vídeo ou um canal. Além disso, o comentário pode ser de nível superior ou uma resposta a um comentário de nível superior.A API é compatível com os seguintes métodos para recursos
comment:comments.list: recuperar uma lista de comentários. Use esse método para recuperar todas as respostas a um comentário específico.comments.insert: cria uma resposta a um comentário.comments.update: modificar um comentário.comments.markAsSpam: sinaliza um ou mais comentários como spam.comments.setModerationStatus: define o status de moderação de um ou mais comentários. Por exemplo, aprovar um comentário para exibição pública ou rejeitar um comentário como inadequado para exibição. A solicitação de API precisa ser autorizada pelo proprietário do canal ou vídeo associado aos comentários.comments.delete: exclui um comentário.
O novo escopo
https://www.googleapis.com/auth/youtube.force-sslda API, descrito no histórico de revisões de 2 de abril de 2015, é necessário para chamadas aos métodoscomments.insert,comments.update,comments.markAsSpam,comments.setModerationStatus,comments.delete,commentThreads.insertecommentThreads.update. -
-
O novo guia Como se inscrever para receber notificações push explica o novo suporte da API para notificações push via PubSubHubBub, um protocolo de publicação/assinatura entre servidores para recursos acessíveis pela Web. Seu servidor de callback do PubSubHubBub pode receber notificações de feed Atom quando um canal realiza uma das seguintes atividades:
- envia um vídeo
- atualiza o título de um vídeo
- atualiza a descrição de um vídeo
-
O guia de migração também foi atualizado para incluir o novo suporte a notificações push. No entanto, como a API v2 era compatível com vários outros tipos de notificações push que não são compatíveis com a API v3, a menção ao suporte ao PubSubHubBub ainda está listada na seção Descontinuado desse guia.
-
O novo escopo
https://www.googleapis.com/auth/youtube.force-sslda API agora é válido para qualquer método de API que antes aceitava o escopohttps://www.googleapis.com/auth/youtube. -
A API agora é compatível com os seguintes erros:
Tipo de erro Detalhe do erro Descrição badRequest (400)invalidRatingO método videos.ratevai retornar esse erro se a solicitação tiver um valor inesperado para o parâmetrorating. -
O método
subscriptions.insertnão é mais compatível com o errosubscriptionLimitExceeded, que antes indicava que o assinante identificado com a solicitação havia excedido o limite de limitação de taxa de assinatura.
2 de abril de 2015
Esta atualização contém as seguintes alterações:
O novo recurso
captionsrepresenta uma faixa de legenda do YouTube. Uma faixa de legenda está associada a exatamente um vídeo do YouTube.A API é compatível com métodos para listar, inserir, atualizar, fazer o download e excluir faixas de legenda.
O guia de migração também foi atualizado para explicar como migrar aplicativos que ainda usam a funcionalidade de legendas na API v2.
O novo escopo
https://www.googleapis.com/auth/youtube.force-sslda API exige que a comunicação com o servidor de API aconteça por uma conexão SSL.Esse novo escopo concede o mesmo acesso que o escopo
https://www.googleapis.com/auth/youtube. Na verdade, esses dois escopos são funcionalmente idênticos porque o servidor de API do YouTube só está disponível por um endpoint HTTPS. Como resultado, mesmo que o escopohttps://www.googleapis.com/auth/youtubenão exija uma conexão SSL, não há outra maneira de fazer uma solicitação de API.O novo escopo é necessário para chamadas para todos os métodos do recurso
caption.
11 de março de 2015
Esta atualização contém as seguintes alterações:
O guia de migração da API YouTube Data (v3) contém uma nova guia, chamada Novidades na API v3, que lista os recursos compatíveis com a API v3, mas não com a v2. Os mesmos recursos estavam e ainda estão listados em outras guias do guia. Por exemplo, o novo recurso que explica como atualizar os dados da campanha promocional in-video de um canal também está listado na guia Canais (perfis).
O guia de migração da API YouTube Data (v3) foi atualizado para informar que a API v3 será compatível com o seguinte recurso da API v2:
O guia de migração da API YouTube Data (v3) foi atualizado para informar que os seguintes recursos da API v2 não serão compatíveis com a API v3:
- Recuperar recomendações de vídeo:
a API v3 não recupera uma lista que contém apenas vídeos recomendados
para o usuário atual da API. No entanto, é possível usar a API v3 para encontrar
vídeos recomendados chamando o método
activities.liste definindo o valor do parâmetrohomecomotrue.
Na resposta da API, um recurso corresponde a um vídeo recomendado se o valor da propriedade
snippet.typeforrecommendation. Nesse caso, as propriedadescontentDetails.recommendation.reasonecontentDetails.recommendation.seedResourceIdvão conter informações sobre o motivo da recomendação do vídeo. Não há garantia de que a resposta vai conter um número específico de vídeos recomendados.Recuperar novos vídeos de inscrição: a API v3 não recupera uma lista que contém apenas vídeos que foram enviados recentemente para canais em que o usuário da API se inscreveu. No entanto, é possível usar a API v3 para encontrar novos vídeos de inscrição chamando o método
activities.liste definindo o valor do parâmetrohomecomotrue.
Na resposta da API, um recurso corresponde a um novo vídeo de inscrição se o valor da propriedade
snippet.typeforupload. Não há garantia de que a resposta vai conter um número específico de novos vídeos de inscrição.Notificações push para atualizações de feed: a API v2 era compatível com notificações push, usando o Simple Update Protocol (SUP) ou o PubSubHubbub, para monitorar os feeds de atividade dos usuários do YouTube. As notificações eram enviadas para novas inscrições no canal e quando os vídeos eram avaliados, compartilhados, marcados como favoritos, comentados ou enviados.
A API v3 vai oferecer suporte a notificações push usando o protocolo PubSubHubbub, mas as notificações vão abranger apenas uploads de vídeos e atualizações de títulos ou descrições de vídeos.
Local do canal: a API v2 usava a tag
<yt:location>para identificar o local do usuário, conforme inserido no perfil público do YouTube do canal. Embora alguns desenvolvedores tenham usado esse campo para associar um canal a um país específico, os dados do campo não podiam ser usados de forma consistente para essa finalidade.Definir ou recuperar tags de desenvolvedor: a API v2 permitia associar palavras-chave ou tags de desenvolvedor a um vídeo no momento do upload. As tags de desenvolvedor não seriam exibidas para os usuários do YouTube, mas os proprietários de vídeos poderiam recuperar vídeos que correspondessem a uma tag de desenvolvedor específica.
A API v3 vai oferecer um recurso semelhante, mas não idêntico. Especificamente, um desenvolvedor poderá pesquisar vídeos enviados pelo próprio aplicativo. Para esse recurso, cada vídeo enviado é marcado automaticamente com o número do projeto associado ao aplicativo do desenvolvedor no Google Developers Console. O desenvolvedor usa o mesmo número de projeto para pesquisar vídeos.
- Listar vídeos por data de publicação, contagem de visualizações ou
classificação:
na API v2, o parâmetro
orderbypermitia classificar os vídeos em uma playlist por posição, duração, data de publicação, título e vários outros valores. Na API v3, os itens da playlist geralmente são classificados por posição em ordem crescente, e outras opções de classificação não estão disponíveis.
Existem algumas exceções. Um novo upload, vídeo favorito, vídeo marcado com "Gostei" ou vídeo assistido recentemente é adicionado automaticamente como o primeiro item (
snippet.position=0) para os seguintes tipos de playlists. Portanto, cada uma dessas listas é classificada do item mais recente para o mais antigo com base no momento em que os itens foram adicionados à lista.- uploads de usuários
- vídeos favoritos
- vídeos marcados como "Gostei"
- histórico de visualização
No entanto, um novo item adicionado à playlist "Assistir mais tarde" é adicionado como o último item dessa lista, de modo que ela é classificada do item mais antigo para o mais recente.
- Processamento em lote:
a API v3 é compatível com um dos casos de uso de processamento em lote que a API v2
aceitava. Os métodos
channels.list,channelSections.list,guideCategories.list,playlistItems.list,playlists.list,subscriptions.list,videoCategories.listevideos.listda API v3 são compatíveis com um parâmetroid, que pode ser usado para especificar uma lista de IDs delimitada por vírgulas (IDs de vídeo, IDs de canal etc.). Com esses métodos, é possível recuperar uma lista de vários recursos com uma única solicitação.
Com essas mudanças, o guia agora identifica todas as funcionalidades que eram compatíveis com a API antiga (v2) e que serão descontinuadas na versão atual da API (v3).
- Recuperar recomendações de vídeo:
a API v3 não recupera uma lista que contém apenas vídeos recomendados
para o usuário atual da API. No entanto, é possível usar a API v3 para encontrar
vídeos recomendados chamando o método
4 de março de 2015
Esta atualização contém as seguintes alterações:
-
Os métodos
channelSections.deleteechannelSections.updateagora aceitam o parâmetroonBehalfOfContentOwner, que já é aceito por vários outros métodos. -
As seguintes propriedades e as propriedades filhas delas foram descontinuadas:
brandingSettings.image.backgroundImageUrlbrandingSettings.image.largeBrandedBannerImageImapScriptbrandingSettings.image.largeBrandedBannerImageUrlbrandingSettings.image.smallBrandedBannerImageImapScriptbrandingSettings.image.smallBrandedBannerImageUrl
Observação: nenhuma dessas propriedades estava sujeita à política de descontinuação da API.
-
A nova propriedade
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasonsdo recursovideoidentifica os motivos que explicam por que o vídeo recebeu a classificação do DJCQT (Brasil). -
A API agora é compatível com os seguintes erros:
Tipo de erro Detalhe do erro Descrição notFound (404)channelNotFoundO método channels.updateretornará esse erro se o parâmetroidda solicitação especificar um canal que não pode ser encontrado.badRequest (400)manualSortRequiredinvalidValueOs métodos playlistItems.inserteplaylistItems.updateretornam esse erro se a solicitação tentar definir a posição do item da playlist, mas a playlist não usar a classificação manual. Por exemplo, os itens da playlist podem ser classificados por data ou popularidade. Para resolver esse erro, remova o elementosnippet.positiondo recurso enviado no corpo da solicitação. Se você quiser que o item da playlist tenha uma posição específica na lista, primeiro atualize a configuração de ordenação da playlist para Manual. Essa configuração pode ser ajustada no Gerenciador de vídeos do YouTube.forbidden (403)channelClosedO método playlists.listretorna esse erro se o parâmetrochannelIdda solicitação especificar um canal que foi fechado.forbidden (403)channelSuspendedO método playlists.listvai retornar esse erro se o parâmetrochannelIdda solicitação especificar um canal que foi suspenso.forbidden (403)playlistForbiddenO método playlists.listvai retornar esse erro se o parâmetroidda solicitação não for compatível com ela ou se a solicitação não estiver devidamente autorizada.notFound (404)channelNotFoundO método playlists.listretornará esse erro se o parâmetrochannelIdda solicitação especificar um canal que não pode ser encontrado.notFound (404)playlistNotFoundO método playlists.listvai retornar esse erro se o parâmetroidda solicitação especificar uma playlist que não pode ser encontrada.notFound (404)videoNotFoundO método videos.listvai retornar esse erro se o parâmetroidda solicitação especificar um vídeo que não foi encontrado.badRequest (400)invalidRatingO método videos.ratevai retornar esse erro se a solicitação tiver um valor inesperado para o parâmetrorating.
2 de março de 2015
Esta atualização contém as seguintes alterações:
O método
search.listagora é compatível com o parâmetrorelevanceLanguage, que permite solicitar resultados mais relevantes para um idioma específico.O guia de migração da API YouTube Data (v3) também foi atualizado para explicar como usar esse novo parâmetro. O parâmetro resolve uma lacuna de recursos que existia entre a versão atual da API (v3) e a versão anterior (v2), que já foi descontinuada.
O guia de migração da API YouTube Data (v3) também foi atualizado para indicar a descontinuação dos feeds especiais e campos de metadados que a API v2 fornecia para descrever filmes, trailers, programas de TV, temporadas de TV e episódios de TV.
14 de janeiro de 2015
Esta atualização contém as seguintes alterações:
-
O guia de migração da API YouTube Data (v3) foi atualizado para explicar como usar a API v3 para enviar vídeos usando JavaScript. Consulte a seção Enviar um vídeo para mais detalhes. Essa funcionalidade é comparável ao upload baseado em navegador que a API v2 oferece. Essa mudança no guia de migração não reflete uma mudança real na API, mas sim a disponibilidade de um novo exemplo de código para fazer upload de vídeos com JavaScript do lado do cliente.
Como agora é possível fazer upload de vídeos com a biblioteca de cliente JavaScript e o CORS, o guia de migração não lista mais o upload baseado em navegador como um recurso que pode ser descontinuado na API v3.
-
A documentação do método
videos.insertfoi atualizada para incluir o novo exemplo de código JavaScript descrito acima. A lista de exemplos de código JavaScript para a API YouTube Data (v3) também foi atualizada.
11 de novembro de 2014
Esta atualização contém as seguintes alterações:
O custo de cota para uma chamada ao método
search.listmudou para 100 unidades.Importante: em muitos casos, é possível usar outros métodos de API para recuperar informações com um custo de cota menor. Por exemplo, considere estas duas maneiras de encontrar vídeos enviados para o canal GoogleDevelopers.
- Custo da cota: 100 unidades
Chame o método
search.liste pesquiseGoogleDevelopers.- Custo da cota: 6 unidades
Chame o método
channels.listpara encontrar o ID do canal certo. Defina o parâmetroforUsernamecomoGoogleDeveloperse o parâmetropartcomocontentDetails. Na resposta da API, a propriedadecontentDetails.relatedPlaylists.uploadsespecifica o código da playlist para os vídeos enviados do canal.Em seguida, chame o método
playlistItems.liste defina o parâmetroplaylistIdcomo o ID capturado e o parâmetropartcomosnippet.
8 de outubro de 2014
Esta atualização contém as seguintes alterações:
-
O recurso
channelcontém duas novas propriedades:-
A propriedade
status.longUploadsStatusindica se o canal está qualificado para enviar vídeos com mais de 15 minutos. Essa propriedade só será retornada se o proprietário do canal tiver autorizado a solicitação de API. Os valores de propriedade válidos são:allowed: o canal pode enviar vídeos com mais de 15 minutos de duração.eligible: o canal pode enviar vídeos com mais de 15 minutos, mas precisa ativar o recurso primeiro.disallowed: o canal não pode ou não está qualificado para enviar vídeos com mais de 15 minutos de duração.
Consulte a definição da propriedade para mais informações sobre esses valores. A Central de Ajuda do YouTube também oferece informações mais detalhadas sobre esse recurso.
-
A propriedade
invideoPromotion.useSmartTimingindica se a campanha promocional do canal usa o "tempo inteligente". Esse recurso tenta mostrar as promoções em um momento do vídeo em que é mais provável que elas sejam clicadas e menos provável que atrapalhem a experiência de visualização. Esse recurso também escolhe uma única promoção para mostrar em cada vídeo.
-
-
As definições das propriedades
snippet.titleesnippet.categoryIddo recursovideoforam atualizadas para esclarecer como a API processa chamadas para o métodovideos.update. Se você chamar esse método para atualizar a partesnippetde um recursovideo, será necessário definir um valor para as duas propriedades.Se você tentar atualizar a parte
snippetde um recursovideoe não definir um valor para as duas propriedades, a API vai retornar um erroinvalidRequest. A descrição desse erro também foi atualizada. -
A propriedade
contentDetails.contentRating.oflcRatingdo recursovideo, que identifica a classificação de um vídeo do Departamento de Classificação de Filmes e Literatura da Nova Zelândia, agora é compatível com duas novas classificações:oflcRp13eoflcRp16. Eles correspondem às classificaçõesRP13eRP16, respectivamente. -
O método
channelBanners.insertagora aceita o seguinte erro:Tipo de erro Detalhe do erro Descrição badRequestbannerAlbumFullO álbum de arte do canal do YouTube do proprietário tem muitas imagens. O proprietário do canal deve acessar http://photos.google.com, navegar até a página de álbuns e remover algumas imagens do álbum em questão.
12 de setembro de 2014
Esta atualização contém as seguintes alterações:
- O custo da cota para uma chamada ao método
search.listmudou de 1 para 2 unidades, além do custo das partes de recursos especificadas.
13 de agosto de 2014
Esta atualização contém as seguintes alterações:
-
O método
subscriptions.insertagora aceita o seguinte erro:Tipo de erro Detalhe do erro Descrição badRequestsubscriptionLimitExceededO assinante identificado com a solicitação excedeu o limite de limitação de taxa de assinatura. Tente de novo em algumas horas.
12 de agosto de 2014
Esta atualização contém as seguintes alterações:
- Um novo guia, intitulado Migrating Your Application to YouTube Data API (v3), explica como usar a API YouTube Data (v3) para executar as funcionalidades disponíveis na API YouTube Data (v2). A API mais antiga foi oficialmente descontinuada em 4 de março de 2014. O objetivo do guia é ajudar você a migrar aplicativos que ainda usam a API v2 para a versão mais recente da API.
8 de julho de 2014
Esta atualização contém as seguintes alterações:
-
O método
playlists.insertagora aceita o seguinte erro:Tipo de erro Detalhe do erro Descrição badRequestmaxPlaylistExceededEsse erro ocorre quando não é possível criar uma playlist porque o canal já atingiu o número máximo permitido.
18 de junho de 2014
Esta atualização contém as seguintes alterações:
A descrição de cada método de API foi atualizada para incluir o custo de cota gerado por uma chamada para esse método. Da mesma forma, as definições dos parâmetros
partforam atualizadas para especificar o custo de cota de cada parte que pode ser recuperada em uma chamada de API. Por exemplo, uma chamada para o métodosubscriptions.inserttem um custo de cota de aproximadamente 50 unidades. O recursosubscriptiontambém contém três partes (snippet,contentDetailsesubscriberSnippet), e cada uma delas tem um custo de duas unidades.Lembre-se de que os custos de cota podem mudar sem aviso prévio.
O recurso
videoagora é compatível com 43 novos sistemas de classificação de conteúdo, que identificam as classificações que os vídeos receberam de várias agências nacionais de classificação. Os novos sistemas de classificação aceitos são de Argentina, Áustria, Bélgica, Bulgária, Chile (televisão), Chile (filme), República Tcheca, Colômbia, Dinamarca, Egito, Estônia, Finlândia, França, Grécia, Hong Kong, Islândia, Indonésia, Irlanda, Israel, Itália, Quênia, Letônia, Luxemburgo, Malásia, Maldivas, Malta, Países Baixos, Nigéria, Noruega, Peru, Filipinas, Portugal, Romênia, Singapura, Eslováquia, África do Sul, Suécia, Suíça, Taiwan, Tailândia e Venezuela.
28 de maio de 2014
Esta atualização contém as seguintes alterações:
O método
search.listagora é compatível com os parâmetroslocationelocationRadius, que permitem pesquisar vídeos associados a uma localização geográfica. Uma solicitação precisa especificar um valor para os dois parâmetros para recuperar resultados com base na localização, e a API vai retornar um erro se uma solicitação incluir apenas um dos dois parâmetros.- O parâmetro
locationespecifica as coordenadas de latitude e longitude no centro da área geográfica circular. - O parâmetro
locationRadiusespecifica a distância máxima que o local associado a um vídeo pode estar do centro da área para que o vídeo ainda seja incluído nos resultados da pesquisa.
- O parâmetro
13 de maio de 2014
Esta atualização contém as seguintes alterações:
A propriedade
invideoPromotion.items[]do recursochannelfoi atualizada para indicar que, normalmente, só é possível definir um item promovido para seu canal. Se você tentar inserir muitos itens promovidos, a API vai retornar um errotooManyPromotedItems, que tem um código de status HTTP400.O recurso
channelSectionagora pode conter informações sobre alguns novos tipos de conteúdo em destaque. A propriedadesnippet.typedo recursochannelSectionagora aceita os seguintes valores:postedPlaylists: playlists que o proprietário do canal postou no feed de atividades do canal.postedVideos: vídeos que o proprietário do canal postou no feed de atividades do canal.subscriptions: canais em que o proprietário do canal se inscreveu.
A nova propriedade
contentDetails.contentRating.ifcoRatingdo recursovideoidentifica a classificação que um vídeo recebeu do Irish Film Classification Office.A definição da propriedade
position.cornerPositiondo recursowatermarkfoi atualizada para indicar que a marca-d'água sempre aparece no canto superior direito do player.A definição do parâmetro
qpara o métodosearch.listfoi atualizada para observar que o termo de consulta pode usar o operador booleano NOT (-) para excluir vídeos associados a um termo de pesquisa específico. O valor também pode usar o operador booleano OR (|) para encontrar vídeos associados a um dos vários termos de pesquisa.A definição da propriedade
pageInfo.totalResultsretornada em uma resposta da API a uma chamadasearch.listfoi atualizada para indicar que o valor é uma aproximação e pode não representar um valor exato. Além disso, o valor máximo é 1.000.000. Não use esse valor para criar links de paginação. Em vez disso, use os valores das propriedadesnextPageTokeneprevPageTokenpara determinar se os links de paginação devem ser mostrados.Os métodos
watermarks.setewatermarks.unsetforam atualizados para refletir que a API retorna um código de resposta HTTP204para solicitações bem-sucedidas para esses métodos.
2 de maio de 2014
Esta atualização contém as seguintes alterações:
O novo recurso
i18nLanguageidentifica um idioma de aplicativo compatível com o site do YouTube. O idioma do aplicativo também pode ser chamado de idioma da interface. No site do YouTube, um idioma do aplicativo pode ser selecionado automaticamente com base nas configurações da Conta do Google, no idioma do navegador ou na localização do IP. Além disso, o usuário pode selecionar manualmente o idioma preferido da interface no rodapé do site do YouTube.A API é compatível com um método para listar os idiomas de aplicativos compatíveis. Os idiomas disponíveis podem ser usados como o valor do parâmetro
hlao chamar métodos de API, comovideoCategories.listeguideCategories.list.O novo recurso
i18nRegionidentifica uma área geográfica que um usuário do YouTube pode selecionar como a região de conteúdo preferida. A região de conteúdo também pode ser chamada de localidade de conteúdo. No site do YouTube, uma região de conteúdo pode ser selecionada automaticamente com base em heurísticas, como o domínio do YouTube ou a localização do IP do usuário. Além disso, o usuário também pode selecionar manualmente uma região de conteúdo preferida no rodapé do site do YouTube.A API é compatível com um método para listar as regiões de conteúdo aceitas. Os códigos de região com disponibilidade podem ser usados como o valor do parâmetro
regionCodeao chamar métodos de API comosearch.list,videos.list,activities.listevideoCategories.list.
7 de abril de 2014
Esta atualização contém as seguintes alterações:
O novo recurso
channelSectioncontém informações sobre um conjunto de vídeos que um canal escolheu destacar. Por exemplo, uma seção pode destacar os envios mais recentes, os envios mais populares ou vídeos de uma ou mais playlists.A API é compatível com métodos para listar, inserir, atualizar ou excluir seções de canal. É possível recuperar uma lista de seções do canal do usuário autenticado especificando um ID de canal específico ou uma lista de IDs de seção de canal exclusivos.
A documentação de erros também foi atualizada para descrever as mensagens de erro que a API aceita especificamente para esses novos métodos.
A definição do objeto
fileDetailsdo recursovideofoi atualizada para explicar que esse objeto só será retornado se a propriedadeprocessingDetails.fileDetailsAvailabilitydo vídeo tiver um valor deavailable.Da mesma forma, a definição do objeto
suggestionsdo recursovideofoi atualizada para explicar que esse objeto só será retornado se a propriedadeprocessingDetails.tagSuggestionsAvailabilityouprocessingDetails.editorSuggestionsAvailabilitydo vídeo tiver um valor deavailable.A documentação dos métodos
videos.insertevideos.updatefoi atualizada para refletir que a propriedadestatus.publishAtpode ser definida ao chamar esses métodos.A definição do objeto
invideoPromotiondo recursochannelfoi atualizada para explicar que o objeto só pode ser recuperado pelo proprietário do canal.A lista de parâmetros do método
videos.ratefoi atualizada para refletir que esse método não é compatível com o parâmetroonBehalfOfContentOwner. Esse foi um erro de documentação, já que as solicitações devideos.rateque definem esse parâmetro retornam um erro500.
31 de março de 2014
Esta atualização contém as seguintes alterações:
- A nova propriedade
status.publishAtdo recursovideopermite especificar a data e a hora em que um vídeo privado será publicado. Essa propriedade só pode ser definida se o status de privacidade do vídeo forprivatee o vídeo nunca tiver sido publicado. Essa nova propriedade não está sujeita à política de descontinuação.
13 de março de 2014
Esta atualização contém as seguintes alterações:
-
A API agora é compatível com a parte
contentOwnerDetailspara recursoschannel. A nova parte contém dados do canal que são relevantes para os parceiros do YouTube vinculados ao canal, incluindo o ID do proprietário do conteúdo vinculado ao canal e a data e hora em que o proprietário do conteúdo e o canal foram vinculados. Essa nova parte não está sujeita à política de descontinuação. -
A documentação agora lista o tamanho máximo de caracteres aceito para as seguintes propriedades:
Recurso Propriedade Tamanho máximo channelinvideoPromotion.items[].customMessage40 caracteres videosnippet.title100 caracteres videosnippet.description5.000 bytes videosnippet.tags500 caracteres. O valor da propriedade é uma lista, e as vírgulas entre os itens dela contam para o limite. -
A propriedade
brandingSettings.watch.featuredPlaylistIddo recursochannelfoi descontinuada. A API vai retornar um erro se você tentar definir o valor dele. -
As seguintes propriedades de recurso
videoforam adicionadas à lista de valores que podem ser definidos ao inserir ou atualizar um vídeo: -
A documentação de erros agora especifica o código de resposta HTTP para cada tipo de erro.
-
A API agora é compatível com os seguintes erros:
Tipo de erro Detalhe do erro Descrição badRequest (400)invalidCriteriaO método channels.listretorna esse erro se a solicitação especificar parâmetros de filtro que não podem ser usados em conjunto.badRequest (400)channelTitleUpdateForbiddenO método channels.updateretorna esse erro se você tentar atualizar a partebrandingSettingsde um canal e mudar o valor da propriedadebrandingSettings.channel.title. A API não retornará o erro se você omitir a propriedade.badRequest (400)invalidRecentlyUploadedByO método channels.updatevai retornar esse erro se a propriedadeinvideoPromotion.items[].id.recentlyUploadedByespecificar um ID do canal inválido.badRequest (400)invalidTimingOffsetO método channels.updatevai retornar esse erro se a parteinvideoPromotionespecificar um ajuste de tempo inválido.badRequest (400)tooManyPromotedItemsO método channels.updatevai retornar esse erro se a parteinvideoPromotionespecificar mais do que o número permitido de itens promovidos.forbidden (403)promotedVideoNotAllowedO método channels.updateretorna esse erro se a propriedadeinvideoPromotion.items[].id.videoIdespecificar um ID de vídeo que não pode ser encontrado ou usado como um item promovido.forbidden (403)websiteLinkNotAllowedO método channels.updatevai retornar esse erro se a propriedadeinvideoPromotion.items[].id.websiteUrlespecificar um URL que não é permitido.required (400)requiredTimingTypeO método channels.updateretorna esse erro se uma solicitação não especificar as configurações de tempo padrão para quando o YouTube deve exibir um item promovido.required (400)requiredTimingO método channels.updateprecisa especificar um objetoinvideoPromotion.items[].timingpara cada item promovido.required (400)requiredWebsiteUrlO método channels.updateprecisa especificar uma propriedadeinvideoPromotion.items[].id.websiteUrlpara cada item promovido.badRequest (400)invalidPublishAtO método videos.insertvai retornar esse erro se os metadados da solicitação especificarem um horário de publicação programada inválido.
4 de março de 2014
Esta atualização contém as seguintes alterações:
- A API YouTube Data v3 agora está sujeita à política de descontinuação descrita nos Termos de Serviço das APIs do YouTube. A página que lista as APIs sujeitas à política de descontinuação exclui especificamente algumas funcionalidades da API v3 de estarem sujeitas à política.
5 de dezembro de 2013
Esta atualização contém as seguintes alterações:
A documentação do método
search.listfoi atualizada para refletir corretamente que não é necessário especificar um valor para exatamente um parâmetro de filtro ao enviar uma solicitação de pesquisa. Em vez disso, é possível definir um valor para zero ou um parâmetro de filtro.As definições dos parâmetros do método
search.listforam atualizadas para indicar que é necessário definir o valor do parâmetrotypecomovideose você também especificar um valor para qualquer um dos seguintes parâmetros:eventTypevideoCaptionvideoCategoryIdvideoDefinitionvideoDimensionvideoDurationvideoEmbeddablevideoLicensevideoSyndicatedvideoType
O tamanho mínimo das imagens de banner do canal enviadas foi reduzido para 2048 px por 1152 px. Antes, o tamanho mínimo era de 2.120 x 1.192 pixels. Além disso, observe que a documentação do recurso
channelespecifica os tamanhos máximos de todas as imagens do banner veiculadas pela API. Por exemplo, o tamanho máximo da imagembrandingSettings.image.bannerTvImageUrlpara aplicativos de televisão é de 2.120 px por 1.192 px, mas a imagem real pode ser de 2.048 px por 1.152 px. A Central de Ajuda do YouTube oferece mais orientações sobre como otimizar a arte do canal para exibição em diferentes tipos de dispositivos.Várias definições de propriedade de recurso do
channelforam atualizadas para refletir as seguintes informações:- O valor da propriedade
brandingSettings.channel.descriptiontem um comprimento máximo de 1.000 caracteres. - A propriedade
brandingSettings.channel.featuredChannelsTitletem um comprimento máximo de 30 caracteres. - A propriedade
brandingSettings.channel.featuredChannelsUrls[]agora pode listar até 100 canais. - O valor da propriedade
brandingSettings.channel.unsubscribedTrailer, se definido, precisa especificar o ID de um vídeo público ou não listado do YouTube que pertence ao proprietário do canal.
- O valor da propriedade
O método
channels.updateagora é compatível com atualizações na propriedadeinvideoPromotion.items[].promotedByContentOwner. Essa propriedade indica se o nome do proprietário do conteúdo será mostrado ao exibir a promoção. Ela só pode ser definida se a solicitação de API que define o valor da propriedade estiver sendo feita em nome do proprietário do conteúdo usando o parâmetroonBehalfOfContentOwner.Os métodos
playlistItems.listeplaylistItems.insertagora aceitam o parâmetroonBehalfOfContentOwner, que já é aceito por vários outros métodos.A propriedade
contentDetails.contentRating.acbRatingagora pode especificar uma classificação do Australian Classification Board (ACB) para filmes ou da Australian Communications and Media Authority (ACMA) para programas de TV infantis.As novas propriedades
contentDetails.contentRating.catvRatingecontentDetails.contentRating.catvfrRatingidentificam as classificações que um vídeo recebeu de acordo com o sistema de classificação de TV canadense e o sistema de classificação Régie du cinéma em francês, usado em Quebec, respectivamente.A nova propriedade
snippet.assignabledo recursovideoCategoryindica se os vídeos atualizados ou enviados recentemente podem ser associados a essa categoria de vídeo.Exemplos de código foram adicionados para os seguintes métodos:
activities.insert(Go)channelBanners.insert(Python)channels.update(Python)playlistItems.list(Go)search.list(Go)thumbnails.set(Java)videos.insert(Go)
24 de outubro de 2013
Esta atualização contém as seguintes alterações:
A API inclui dois recursos adicionais projetados para ajudar a encontrar e destacar conteúdo de transmissão ao vivo:
A nova propriedade
snippet.liveBroadcastContentnos resultados da pesquisa indica se um recurso de vídeo ou canal tem conteúdo de transmissão ao vivo. Os valores de propriedade válidos sãoupcoming,activeenone.A nova propriedade
snippet.liveBroadcastContentdo recursovideoindica se o vídeo é uma transmissão ao vivo futura ou ativa. A lista a seguir explica os valores possíveis da propriedade:upcoming: o vídeo é uma transmissão ao vivo que ainda não começou.active: o vídeo é uma transmissão ao vivo em andamento.none: o vídeo não é uma transmissão ao vivo futura ou ativa. Esse será o valor da propriedade para transmissões concluídas que ainda podem ser visualizadas no YouTube.A nova propriedade
liveStreamingDetailsdo recursovideoé um objeto que contém metadados sobre uma transmissão de vídeo ao vivo. Para recuperar esses metadados, inclualiveStreamingDetailsna lista de partes de recursos do valor de parâmetropart. Os metadados incluem as seguintes propriedades novas:liveStreamingDetails.actualStartTime: o horário em que a transmissão realmente começou. Esse valor estará presente quando o estado da transmissão foractive.liveStreamingDetails.actualEndTime– O horário em que a transmissão realmente terminou. Esse valor vai estar presente quando a transmissão terminar.liveStreamingDetails.scheduledStartTime: o horário em que a transmissão está programada para começar.liveStreamingDetails.scheduledEndTime: o horário em que a transmissão está programada para terminar. Se o valor da propriedade estiver vazio ou a propriedade não estiver presente, a transmissão será programada para continuar indefinidamente.liveStreamingDetails.concurrentViewers: o número de pessoas assistindo a transmissão ao vivo.
Para recuperar esses metadados, inclua
liveStreamingDetailsno valor do parâmetropartao chamar o métodovideos.list,videos.insertouvideos.update.Dois outros recursos para identificar conteúdo de transmissão ao vivo foram lançados em 1º de outubro de 2013: o parâmetro
eventTypedo métodosearch.liste a propriedadesnippet.liveBroadcastContentdo resultado da pesquisa.O método
videos.insertagora é compatível com o parâmetronotifySubscribers, que indica se o YouTube deve enviar uma notificação sobre o novo vídeo aos usuários que se inscreveram no canal do vídeo. O valor padrão do parâmetro éTrue, o que indica que os inscritos serão notificados sobre os vídeos enviados recentemente. No entanto, o proprietário de um canal que envia muitos vídeos pode preferir definir o valor comoFalsepara evitar o envio de uma notificação sobre cada novo vídeo para os inscritos do canal.A lista de propriedades que podem ser modificadas ao chamar o método
channels.updatefoi atualizada para incluir as propriedadesinvideoPromotion.items[].customMessageeinvideoPromotion.items[].websiteUrl. Além disso, a lista foi modificada para identificar as propriedadesbrandingSettingsque podem ser modificadas. Essas propriedadesbrandingSettingsjá eram modificáveis, então a mudança na documentação não reflete uma alteração na funcionalidade da API.Os métodos
playlists.insert,playlists.updateeplaylists.deleteagora aceitam o parâmetroonBehalfOfContentOwner, que já é compatível com vários outros métodos.O método
playlists.insertagora aceita o parâmetroonBehalfOfContentOwnerChannel, que já é aceito por vários outros métodos.A propriedade
contentDetails.contentRating.tvpgRatingdo recursovideoagora aceita um valor depg14, que corresponde a uma classificaçãoTV-14.A definição da propriedade
snippet.liveBroadcastContent, que faz parte dos resultados da pesquisa, foi corrigida para refletir queliveé um valor de propriedade válido, masactivenão é.A propriedade
contentDetails.contentRating.mibacRatingdo recursovideoagora aceita mais duas classificações:mibacVap(VAP): as crianças precisam estar acompanhadas por um adulto.mibacVm6(V.M.6): restrito a maiores de 6 anos.mibacVm12(V.M.12): restrito a maiores de 12 anos.
A nova propriedade
invideoPromotion.items[].promotedByContentOwnerdo recursochannelindica se o nome do proprietário do conteúdo vai aparecer quando a promoção for exibida. Esse campo só pode ser definido se a solicitação de API que define o valor estiver sendo feita em nome do proprietário do conteúdo. Consulte o parâmetroonBehalfOfContentOwnerpara mais informações.
1º de outubro de 2013
Esta atualização contém as seguintes alterações:
-
O novo objeto
auditDetailsdo recursochannelcontém dados do canal que uma rede multicanal (RM) avalia ao determinar se aceita ou rejeita um canal específico. Qualquer solicitação de API que recupere essa parte do recurso precisa fornecer um token de autorização que contenha o escopohttps://www.googleapis.com/auth/youtubepartner-channel-audit. Além disso, qualquer token que use esse escopo precisa ser revogado quando a RM decide aceitar ou rejeitar o canal ou em até duas semanas após a data de emissão do token. -
A propriedade
invideoPromotion.items[].id.typedo recursochannelagora aceita um valor derecentUpload, que indica que o item promovido é o vídeo enviado mais recentemente de um canal especificado.Por padrão, o canal é o mesmo para o qual os dados de promoção in-video estão definidos. No entanto, é possível promover o vídeo mais recente de outro canal definindo o valor da nova propriedade
invideoPromotion.items[].id.recentlyUploadedBycomo o ID do canal desse canal. -
O recurso
channelcontém três novas propriedades (brandingSettings.image.bannerTvLowImageUrl,brandingSettings.image.bannerTvMediumImageUrl,brandingSettings.image.bannerTvHighImageUrl) que especificam os URLs das imagens do banner que aparecem nas páginas do canal em aplicativos de televisão. -
A nova propriedade
snippet.liveBroadcastContentnos resultados da pesquisa indica se um recurso de vídeo ou canal tem conteúdo de transmissão ao vivo. Os valores de propriedade válidos sãoupcoming,activeenone.- Para um recurso
video, um valor deupcomingindica que o vídeo é uma transmissão ao vivo que ainda não começou, enquanto um valor deactiveindica que o vídeo é uma transmissão ao vivo em andamento. - Para um recurso
channel, um valor deupcomingindica que o canal tem uma transmissão programada que ainda não começou, enquanto um valor deaciveindica que o canal tem uma transmissão ao vivo em andamento.
- Para um recurso
-
No recurso
watermark, a propriedadetargetChannelIdmudou de um objeto para uma string. Em vez de conter uma propriedade filha que especifica o ID do canal do YouTube ao qual a imagem da marca d'água está vinculada, a propriedadetargetChannelIdagora especifica esse valor. Por isso, a propriedadetargetChannelId.valuedo recurso foi removida. -
O método
thumbnails.setagora aceita o parâmetroonBehalfOfContentOwner, que já é aceito por vários outros métodos. -
O método
search.listagora é compatível com o parâmetroeventType, que restringe uma pesquisa para retornar apenas eventos de transmissão ativos, futuros ou concluídos. -
A nova propriedade
contentDetails.contentRating.mibacRatingidentifica a classificação que um vídeo recebeu do Ministero dei Beni e delle Attivita Culturali e del Turismo da Itália. -
A API agora é compatível com os seguintes erros:
Tipo de erro Detalhe do erro Descrição badRequestinvalidImageO método thumbnails.setvai retornar esse erro se o conteúdo da imagem fornecida for inválido.forbiddenvideoRatingDisabledO método videos.rateretorna esse erro se o proprietário do vídeo que está sendo avaliado tiver desativado as classificações para esse vídeo.
27 de agosto de 2013
Esta atualização contém as seguintes alterações:
-
O novo recurso
watermarkidentifica uma imagem que aparece durante as reproduções dos vídeos de um canal específico. Você também pode especificar um canal de destino ao qual a imagem será vinculada, além dos detalhes de sincronismo que determinam quando uma marca d'água aparece durante reproduções de vídeo e o período em que ela estará visível.O método
watermarks.setfaz o upload e define a imagem da marca-d'água de um canal. O métodowatermarks.unsetexclui a imagem de marca-d'água de um canal.A documentação de erros descreve as mensagens de erro que a API aceita especificamente para os métodos
watermarks.setewatermarks.unset. -
A nova propriedade
statistics.hiddenSubscriberCountdo recursochannelcontém um valor booleano que indica se o número de inscritos do canal está oculto. Portanto, o valor da propriedade seráfalsese a contagem de inscritos do canal estiver visível publicamente. -
O método
playlists.listagora é compatível com os parâmetrosonBehalfOfContentOwnereonBehalfOfContentOwnerChannel. Ambos os parâmetros já são compatíveis com vários outros métodos. -
O método
videos.listagora é compatível com o parâmetroregionCode, que identifica a região de conteúdo de onde um gráfico deve ser recuperado. Esse parâmetro só pode ser usado com o parâmetrochart. O valor de parâmetro é um código de país ISO 3166-1 alfa-2. -
O
error documentationdescreve o seguinte novo erro de solicitação comum, que pode ocorrer em vários métodos de API:Tipo de erro Detalhe do erro Descrição forbiddeninsufficientPermissionsOs escopos associados ao token do OAuth 2.0 fornecido para a solicitação são insuficientes para acessar os dados solicitados.
15 de agosto de 2013
Esta atualização contém as seguintes alterações:
-
O objeto
invideoPromotiondo recursochanneltem as seguintes propriedades novas e atualizadas:-
Agora, a API permite especificar um site como um item promovido. Para fazer isso, defina o valor da propriedade
invideoPromotion.items[].id.typecomowebsitee use a nova propriedadeinvideoPromotion.items[].id.websiteUrlpara especificar o URL. Use também a nova propriedadeinvideoPromotion.items[].customMessagepara definir uma mensagem personalizada que será exibida na promoção.Os links podem ser associados a websites, sites comerciais ou sites de redes sociais. Consulte as instruções da Central de Ajuda do YouTube sobre sites associados e sites de comerciantes para saber como ativar links no seu conteúdo.
Ao adicionar links promocionais, você concorda que eles não serão usados para redirecionar o tráfego para sites não autorizados e que eles obedecerão às políticas do AdWords, às políticas de anúncios do YouTube, às diretrizes da comunidade do YouTube e aos Termos de Serviço do YouTube.
-
As propriedades relacionadas às configurações de tempo para exibir itens promovidos durante a reprodução de vídeos foram reestruturadas:
-
O objeto
invideoPromotion.timingfoi movido parainvideoPromotion.items[].timing. Esse objeto agora permite personalizar os dados de tempo de cada item promovido na listainvideoPromotion.items[]. -
O novo objeto
invideoPromotion.defaultTimingespecifica as configurações de tempo padrão para sua promoção. Essas configurações definem quando um item promovido vai aparecer durante a reprodução de um dos vídeos do seu canal. É possível modificar o tempo padrão de qualquer item promovido usando o objetoinvideoPromotion.items[].timing. -
A nova propriedade
invideoPromotion.items[].timing.durationMsespecifica o tempo, em milissegundos, em que a promoção deve ser exibida. O objetoinvideoPromotion.defaultTimingtambém contém um campodurationMsque especifica o tempo padrão de exibição do item promovido.
-
-
As propriedades
invideoPromotion.items[].typeeinvideoPromotion.items[].videoIdforam movidas para o objetoinvideoPromotion.items[].id.
-
-
O método
subscriptions.listagora é compatível com os parâmetrosonBehalfOfContentOwnereonBehalfOfContentOwnerChannel. Ambos os parâmetros já são compatíveis com vários outros métodos. -
Na resposta da API a uma solicitação
thumbnails.set, o valor da propriedadekindmudou deyoutube#thumbnailListResponseparayoutube#thumbnailSetResponse. -
Exemplos de código foram adicionados para os seguintes métodos:
channels.update(Java, Python)playlists.insert(.NET, PHP)subscriptions.insert(PHP, Python)thumbnails.set(PHP, Python)videos.insert(PHP)videos.list(PHP)videos.rate(Python)videos.update(Java, PHP, Python)
O exemplo em Python para o método
playlistItems.inserttambém foi removido, já que a funcionalidade demonstrada agora é processada pelo métodovideos.rate. -
O
error documentationdescreve o seguinte novo erro de contexto de solicitação, que pode ocorrer em qualquer método de API compatível com o parâmetro de solicitaçãomine:Tipo de erro Detalhe do erro Descrição badRequestinvalidMineO parâmetro minenão pode ser usado em solicitações em que o usuário autenticado é um parceiro do YouTube. Remova o parâmetromine, autentique-se como um usuário do YouTube removendo o parâmetroonBehalfOfContentOwnerou aja como um dos canais do parceiro fornecendo o parâmetroonBehalfOfContentOwnerChannel, se disponível para o método chamado.
8 de agosto de 2013
Esta atualização contém as seguintes alterações:
- A seção Uso de cota do guia Introdução à API YouTube Data foi atualizada para refletir uma mudança no custo de cota de um envio de vídeo de aproximadamente 16.000 unidades para aproximadamente 1.600 unidades.
30 de julho de 2013
Esta atualização contém as seguintes alterações:
-
Em um recurso
channelBanner, o valor da propriedadekindmudou deyoutube#channelBannerInsertResponseparayoutube#channelBannerResource. Esse recurso é retornado em resposta a uma solicitaçãochannelBanners.insert. -
A nova propriedade
brandingSettings.channel.profileColordo recursochannelespecifica uma cor de destaque que complementa o conteúdo do canal. O valor da propriedade é um sinal de cerquilha (#) seguido por uma string hexadecimal de seis caracteres, como#2793e6. -
A API agora permite especificar se uma inscrição é para todas as atividades de um canal ou apenas para novos envios. A nova propriedade
contentDetails.activityTypedo recursosubscriptionidentifica os tipos de atividades sobre as quais o inscrito será notificado. Os valores de propriedade válidos sãoalleuploads. -
O método
videos.listaceita novos parâmetros para recuperar um gráfico dos vídeos mais assistidos no YouTube:- O parâmetro
chartidentifica o gráfico que você quer recuperar. No momento, o único valor compatível émostPopular. O parâmetrocharté um parâmetro de filtro, o que significa que ele não pode ser usado na mesma solicitação que outros parâmetros de filtro (idemyRating). - O parâmetro
videoCategoryIdidentifica a categoria de vídeo do gráfico que será recuperado. Esse parâmetro só pode ser usado com o parâmetrochart. Por padrão, os gráficos não são restritos a determinada categoria.
- O parâmetro
-
A nova propriedade
topicDetails.relevantTopicIds[]do recursovideofornece uma lista de IDs de tópicos do Freebase que são relevantes para o vídeo ou o conteúdo dele. Os assuntos desses temas podem ser mencionados ou aparecer no vídeo. -
A propriedade
recordingDetails.location.elevationdo recursovideofoi renomeada comorecordingDetails.location.altitude, e a propriedadefileDetails.recordingLocation.location.elevationfoi renomeada comofileDetails.recordingLocation.location.altitude. -
O objeto
contentDetails.contentRatingdo recursovideoespecifica as classificações que um vídeo recebeu em vários esquemas de classificação, incluindo classificações da MPAA, classificações da TVPG e assim por diante. Para cada sistema de classificação, a API agora aceita um valor de classificação que indica que o vídeo não foi classificado. Para as classificações da MPAA, uma classificação "sem classificação" é frequentemente usada para identificar versões sem cortes de filmes em que a versão com cortes recebeu uma classificação oficial. -
A nova propriedade
contentDetails.contentRating.ytRatingdo recursovideoidentifica conteúdo com restrição de idade. O valor da propriedade seráytAgeRestrictedse o YouTube identificar que o vídeo tem conteúdo inadequado para usuários com menos de 18 anos. Se a propriedade estiver ausente ou se o valor dela estiver vazio, o conteúdo não foi identificado como restrito para menores. -
O parâmetro
mySubscribersdo métodochannels.listfoi descontinuado. Use o métodosubscriptions.liste o parâmetromySubscriberspara recuperar uma lista de inscritos no canal do usuário autenticado. -
Os métodos
channelBanners.insert,channels.update,videos.getRatingevideos.rateagora são compatíveis com o parâmetroonBehalfOfContentOwner. Esse parâmetro indica que o usuário autenticado está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro. -
A documentação do método
channels.updatefoi atualizada para refletir o fato de que esse método pode ser usado para atualizar o objetobrandingSettingsdo recursochannele as propriedades filhas dele. A documentação agora também lista as propriedades atualizadas que podem ser definidas para o objetoinvideoPromotiondo recursochannel. -
O
error documentationdescreve os seguintes novos erros:Tipo de erro Detalhe do erro Descrição forbiddenaccountDelegationForbiddenEsse erro não é específico de um método de API específico. Indica que o usuário autenticado não tem autorização para agir em nome da Conta do Google especificada. forbiddenauthenticatedUserAccountClosedEsse erro não é específico de um método de API específico. Indica que a conta do YouTube do usuário autenticado está encerrada. Se o usuário estiver agindo em nome de outra Conta do Google, esse erro indica que essa outra conta está encerrada. forbiddenauthenticatedUserAccountSuspendedEsse erro não é específico de um método de API específico. Indica que a conta do YouTube do usuário autenticado está suspensa. Se o usuário estiver agindo em nome de outra Conta do Google, esse erro indica que a outra conta está suspensa. forbiddenauthenticatedUserNotChannelEsse erro não é específico de um método de API específico. Isso indica que o servidor de API não consegue identificar o canal associado à solicitação de API. Se a solicitação for autorizada e usar o parâmetro onBehalfOfContentOwner, você também precisará definir o parâmetroonBehalfOfContentOwnerChannel.forbiddencmsUserAccountNotFoundEsse erro não é específico de um método de API específico. O usuário do CMS não está autorizado a agir em nome do proprietário do conteúdo especificado. notFoundcontentOwnerAccountNotFoundEsse erro não é específico de um método de API específico. A conta de proprietário do conteúdo especificada não foi encontrada. badRequestinvalidPartEsse erro não é específico de um método de API específico. O parâmetro partda solicitação especifica partes que não podem ser gravadas ao mesmo tempo.badRequestvideoChartNotFoundO método videos.listretorna esse erro quando a solicitação especifica um gráfico de vídeos indisponíveis ou não compatível.notFoundvideoNotFoundO método videos.updateretorna esse erro para indicar que o vídeo que você está tentando atualizar não foi encontrado. Verifique o valor da propriedadeidno corpo da solicitação para garantir que esteja correto.
10 de junho de 2013
Esta atualização contém as seguintes alterações:
-
O novo parâmetro
forUsernamedo métodochannels.listpermite recuperar informações sobre um canal especificando o nome de usuário do YouTube. -
O método
activities.listagora é compatível com o parâmetroregionCode, que instrui a API a retornar resultados relevantes para o país especificado. O YouTube usa esse valor quando a atividade anterior do usuário autorizado no YouTube não fornece informações suficientes para gerar o feed de atividade. -
Os recursos de playlist agora contêm a propriedade
snippet.tags. A propriedade só será retornada para usuários autorizados que estiverem recuperando dados sobre as próprias playlists. Os usuários autorizados também podem definir tags de playlist ao chamar os métodosplaylists.insertouplaylists.update. -
O parâmetro
onBehalfOfContentOwner, que antes era compatível com os métodoschannels.listesearch.list, agora também é compatível com os métodosvideos.insert,videos.updateevideos.delete. Quando esse parâmetro é usado em uma chamada para o métodovideos.insert, a solicitação também precisa especificar um valor para o novo parâmetroonBehalfOfContentOwnerChannel, que identifica o canal em que o vídeo será adicionado. O canal precisa estar vinculado ao proprietário do conteúdo especificado pelo parâmetroonBehalfOfContentOwner.O parâmetro indica que as credenciais de autorização da solicitação identificam um usuário do CMS do YouTube que está agindo em nome do proprietário do conteúdo especificado no valor de parâmetro. A conta do CMS com a qual o usuário autentica deve estar vinculada ao proprietário do conteúdo do YouTube especificado.
Esse parâmetro é destinado a parceiros de conteúdo que têm e gerenciam vários canais do YouTube. O parâmetro permite que esses parceiros façam a autenticação uma vez e tenham acesso a todos os dados de vídeos e canais, sem precisar fornecer credenciais de autenticação para cada canal individual.
Especificamente em relação a esta versão, o parâmetro agora permite que um parceiro de conteúdo insira, atualize ou exclua vídeos em qualquer um dos canais do YouTube que ele possui.
-
O
error documentationdescreve os seguintes novos erros:Tipo de erro Detalhe do erro Descrição forbiddeninsufficientCapabilitiesEsse erro não é específico de um método de API específico. Indica que o usuário do CMS que está chamando a API não tem permissões suficientes para realizar a operação solicitada. Esse erro está associado ao uso do parâmetro onBehalfOfContentOwner, que é compatível com vários métodos de API.unauthorizedauthorizationRequiredO método activities.listretorna esse erro quando a solicitação usa o parâmetrohome, mas não está devidamente autorizada. -
No recurso
channels, a propriedadeinvideoPromotion.channelIdfoi removida porque o ID do canal já está especificado usando a propriedadeiddo recurso. -
O novo guia Como trabalhar com IDs de canal explica como a API usa esses IDs. O guia pode ser especialmente útil para desenvolvedores que estão migrando da versão anterior da API e têm aplicativos que solicitam conteúdo para o usuário
defaultou que dependem da noção de que cada canal do YouTube tem um nome de usuário exclusivo, o que não é mais o caso.
22 de maio de 2013
Esta atualização contém as seguintes alterações:
- O novo método
channelBanners.insertpermite fazer upload de uma imagem de banner que pode ser definida como a imagem de banner de um canal usando a nova propriedadebrandingSettings.image.bannerExternalUrldo recursochannel. - A documentação do método
channels.updatefoi atualizada para listar as propriedades que podem ser modificadas ao chamar o método. - A documentação do recurso
videonão lista maisunspecifiedcomo um valor de propriedade válido para as propriedadessuggestions.processingErrors[],suggestions.processingHints[],suggestions.processingWarnings[]esuggestions.editorSuggestions[]. - O parâmetro
maxResultsdo métodovideos.listagora tem um valor padrão de5. - O
error documentationagora lista erros para os métodoschannelBanners.insertesubscriptions.list. Ele também lista vários novos erros para o métodochannels.update.
14 de maio de 2013
Esta atualização contém as seguintes alterações:
- As páginas independentes agora listam exemplos de código para Java, .NET, PHP e Ruby.
- A página que lista exemplos de código Python agora inclui exemplos para adicionar uma inscrição, criar uma playlist e atualizar um vídeo.
10 de maio de 2013
Esta atualização contém as seguintes alterações:
- O YouTube não identifica mais os recursos e serviços experimentais da API. Em vez disso, agora fornecemos uma lista de APIs do YouTube que estão sujeitas à política de descontinuação.
8 de maio de 2013
Esta atualização contém as seguintes alterações:
Os recursos de canal agora são compatíveis com o objeto
inVideoPromotion, que encapsula informações sobre uma campanha promocional associada ao canal. Um canal pode usar uma campanha promocional in-video para exibir imagens em miniatura de um vídeo promovido no player de vídeo durante as reproduções dos vídeos do canal.Para recuperar esses dados, inclua
invideoPromotionno valor do parâmetropartem uma solicitaçãochannels.list.O novo método
channels.updatepode ser usado para atualizar os dados da campanha promocional in-video de um canal. O método só é compatível com atualizações na parteinvideoPromotiondo recursochannele não é compatível com atualizações em outras partes desse recurso.
2 de maio de 2013
Esta atualização contém as seguintes alterações:
Os recursos de canal agora são compatíveis com a propriedade
status.isLinked, que indica se os dados do canal identificam um usuário que já está vinculado a um nome de usuário do YouTube ou a uma conta do Google+. Um usuário que tem um desses links já tem uma identidade pública do YouTube, que é um pré-requisito para várias ações, como o envio de vídeos.Os recursos de inscrição agora são compatíveis com a parte
subscriberSnippet. Esse objeto encapsula os dados do snippet de contêiner do canal do inscrito.A API agora é compatível com o método
videos.getRating, que recupera as classificações que o usuário autenticado deu a uma lista de um ou mais vídeos.O novo parâmetro
myRatingdo métodovideos.listpermite recuperar uma lista de vídeos que o usuário autenticado classificou com uma classificaçãolikeoudislike.O parâmetro
myRatinge o parâmetroidagora são considerados parâmetros de filtro, o que significa que uma solicitação de API precisa especificar exatamente um dos parâmetros. Anteriormente, o parâmetroidera obrigatório para esse método.O método retorna um erro
forbiddenpara solicitações que tentam recuperar informações de classificação de vídeo, mas não estão devidamente autorizadas para isso.Com a introdução do parâmetro
myRating, o métodovideos.listtambém foi atualizado para oferecer suporte à paginação. No entanto, os parâmetros de paginação só são compatíveis com solicitações que usam o parâmetromyRating. Os parâmetros e as informações de paginação não são compatíveis com solicitações que usam o parâmetroid.- O parâmetro
maxResultsespecifica o número máximo de vídeos que a API pode retornar no conjunto de resultados, e o parâmetropageTokenidentifica uma página específica no conjunto de resultados que você quer recuperar. - O recurso
youtube#videoListResponse, que é retornado em resposta a uma solicitaçãovideos.list, agora contém o objetopageInfo, que inclui detalhes como o número total de resultados e o número de resultados incluídos no conjunto de resultados atual. O recursoyoutube#videoListResponsetambém pode incluir as propriedadesnextPageTokeneprevPageToken, cada uma fornecendo um token que pode ser usado para recuperar uma página específica no conjunto de resultados.
- O parâmetro
O método
videos.insertaceita os seguintes novos parâmetros:autoLevels: defina esse valor de parâmetro comotruepara instruir o YouTube a melhorar automaticamente a iluminação e as cores do vídeo.stabilize: defina esse valor de parâmetro comotruepara instruir o YouTube a ajustar o vídeo removendo a trepidação resultante dos movimentos da câmera.
A propriedade
channelTitlefoi adicionada aosnippetpara os seguintes recursos:playlistItem: a propriedade especifica o nome do canal que adicionou o item da playlist.playlist: a propriedade especifica o nome do canal que criou a playlist.subscription: a propriedade especifica o nome do canal inscrito.
Exemplos de código foram adicionados para os seguintes métodos:
activities.insert(Ruby)playlistItems.list(.NET)search.list(.NET)subscriptions.insert(Java, Ruby)videos.insert(.NET, Ruby)
O novo parâmetro
mySubscribersdo métodosubscriptions.listpermite recuperar uma lista de inscritos do usuário autenticado. Esse parâmetro só pode ser usado em uma solicitação devidamente autorizada.Observação: essa funcionalidade foi criada para substituir o parâmetro
mySubscriberscompatível com o métodochannels.list. Esse parâmetro será descontinuado.Em um recurso
video, o valor da propriedadeunspecifiednão é mais um valor possível para nenhuma das seguintes propriedades:As solicitações de API que contêm um parâmetro inesperado agora retornam um erro
badRequest, e o motivo informado para o erro éunexpectedParameter.O erro que o método
playlistItems.insertretorna quando a playlist já contém o número máximo de itens permitidos foi atualizado. O erro agora é relatado como um erroforbidden, e o motivo do erro éplaylistContainsMaximumNumberOfVideos.
19 de abril de 2013
Esta atualização contém as seguintes alterações:
-
O novo método
videos.ratepermite que um usuário defina uma classificaçãolikeoudislikeem um vídeo ou remova uma classificação de um vídeo.A documentação de erros também foi atualizada para listar os erros que a API pode retornar em resposta a uma chamada de método
videos.rate. -
As imagens de miniatura agora são identificadas na documentação da API como um recurso separado, e o novo método
thumbnails.setpermite que você envie uma miniatura de vídeo personalizada para o YouTube e a defina para um vídeo.A documentação de erros também foi atualizada para listar os erros que a API pode retornar em resposta a uma chamada de método
thumbnails.set.Essa mudança não afeta os recursos atuais que retornam imagens em miniatura. As imagens de miniatura são retornadas nesses recursos da mesma forma que antes, mas agora a documentação lista os nomes dos diferentes tamanhos de miniatura que a API pode retornar.
-
A nova parte
brandingSettingsdo recursochannelidentifica configurações, texto e imagens para a página do canal e as páginas de exibição de vídeo. -
O recurso
playlistItemcontém as seguintes propriedades novas:-
O novo objeto
statusencapsula informações de status sobre o item da playlist, e a propriedadestatus.privacyStatusidentifica o status de privacidade do item.
-
-
O recurso
videocontém as seguintes propriedades novas:-
A propriedade
status.publicStatsViewableindica se as estatísticas de vídeo estendidas na página de exibição estão disponíveis para visualização pública. Por padrão, essas estatísticas são visíveis, e as estatísticas como a contagem de visualizações e as classificações de um vídeo ainda estarão visíveis publicamente, mesmo que o valor dessa propriedade esteja definido comofalse. É possível definir o valor dessa propriedade ao chamar o métodovideos.insertouvideos.update. -
O objeto
contentDetails.contentRatingencapsula as classificações que o vídeo recebeu em vários esquemas de classificação. A lista abaixo identifica os sistemas de classificação aceitos e fornece um link para a propriedade associada a cada um deles. As definições de propriedade identificam os valores de classificação aceitos para cada sistema.País Sistema de classificação Propriedade United StatesMotion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRatingUnited StatesOrientação dos pais para a televisão contentDetails.contentRating.tvpgRatingAustraliaConselho Australiano de Classificação (ACB, na sigla em inglês) contentDetails.contentRating.acbRatingBrazilDepartamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRatingCanadaSistema de classificação de vídeos domésticos do Canadá (CHVRS, na sigla em inglês) contentDetails.contentRating.chvrsRatingFranceCentre national du cinéma et de l'image animée (Ministério da Cultura da França) contentDetails.contentRating.fmocRatingGermanyFreiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRatingGreat BritainBritish Board of Film Classification (BBFC) contentDetails.contentRating.bbfcRatingIndiaCentral Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRatingJapan映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRatingKorea영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRatingMexicoDiretoria Geral de Rádio, Televisão e Cinematografia (RTC) contentDetails.contentRating.rtcRatingNew ZealandOffice of Film and Literature Classification contentDetails.contentRating.oflcRatingRussiaRegistro Nacional de Filmes da Federação Russa contentDetails.contentRating.russiaRatingSpainInstituto de la Cinematografía y de las Artes Audiovisuales (ICAA)contentDetails.contentRating.icaaRating
-
-
A documentação do método
playlistItems.updatefoi atualizada para refletir o fato de que a propriedadesnippet.resourceIdprecisa ser especificada no recurso enviado como o corpo da solicitação. -
O método
search.listagora oferece suporte às seguintes funcionalidades:-
O novo parâmetro
forMinerestringe uma pesquisa para recuperar apenas os vídeos do usuário autenticado. -
O parâmetro
orderagora permite classificar os resultados em ordem alfabética por título (order=title) ou por contagem de vídeos em ordem decrescente (order=videoCount). -
O novo parâmetro
safeSearchindica se os resultados da pesquisa devem incluir conteúdo restrito.
-
-
O método
videos.inserté compatível com vários erros novos, que estão listados na tabela abaixo:Tipo de erro Detalhe do erro Descrição badRequestinvalidCategoryIdA propriedade snippet.categoryIdespecifica um ID de categoria inválido. Use o métodovideoCategories.listpara recuperar as categorias compatíveis.badRequestinvalidRecordingDetailsO metadataespecifica detalhes de gravação inválidos.badRequestinvalidVideoGameRatingOs metadados da solicitação especificam uma classificação de videogame inválida. badRequestinvalidVideoMetadataOs metadados da solicitação são inválidos. -
O parâmetro
onBehalfOfContentOwnerfoi removido da lista de parâmetros compatíveis com os métodosvideos.updateevideos.delete.
12 de março de 2013
Esta atualização contém as seguintes alterações:
A propriedade
channelTitlefoi adicionada aosnippetpara os seguintes recursos:O método
search.listé compatível com os seguintes novos parâmetros:- O parâmetro
channelTypepermite restringir uma pesquisa de canais para recuperar todos os canais ou apenas programas. - O parâmetro
videoTypepermite restringir uma pesquisa de vídeos para recuperar todos os vídeos ou apenas filmes ou episódios de programas.
- O parâmetro
A definição da parte
recordingDetailsdo recursovideofoi atualizada para observar que o objeto só será retornado para um vídeo se os dados de geolocalização ou o tempo de gravação do vídeo tiverem sido definidos.O método
playlistItems.updateagora retorna um erroinvalidSnippet, que é retornado se a solicitação de API não especificar um snippet válido.Vários métodos de API são compatíveis com novos parâmetros destinados exclusivamente a parceiros de conteúdo do YouTube. Os parceiros de conteúdo do YouTube incluem estúdios de cinema e televisão, gravadoras e outros criadores de conteúdo que disponibilizam o conteúdo deles no YouTube.
- O parâmetro
onBehalfOfContentOwnerindica que as credenciais de autorização da solicitação identificam um usuário do CMS do YouTube que está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro. A conta do CMS usada para autenticação precisa estar vinculada ao proprietário do conteúdo do YouTube especificado.
Esse parâmetro é destinado a parceiros de conteúdo que possuem e gerenciam muitos canais diferentes do YouTube. O parâmetro permite que esses parceiros se autentiquem uma vez e tenham acesso a todos os dados de vídeo e canal, sem precisar fornecer credenciais de autenticação para cada canal individual.
Os métodos
channels.list,search.list,videos.delete,videos.listevideos.updatesão compatíveis com esse parâmetro.O parâmetro
managedByMe, que é compatível com o métodochannels.list, instrui a API a retornar todos os canais que pertencem ao proprietário do conteúdo especificado pelo parâmetroonBehalfOfContentOwner.O parâmetro
forContentOwner, que é compatível com o métodosearch.list, instrui a API a restringir os resultados da pesquisa para incluir apenas recursos que pertencem ao proprietário do conteúdo especificado pelo parâmetroonBehalfOfContentOwner.
- O parâmetro
25 de fevereiro de 2013
Esta atualização contém as seguintes alterações:
A API é compatível com várias novas partes e propriedades para recursos
video:As novas partes
fileDetails,processingDetailsesuggestionsfornecem informações aos proprietários de vídeos sobre os vídeos enviados. Esses dados são muito úteis em aplicativos que permitem o upload de vídeos e incluem o seguinte:status e progresso do processamento
erros ou outros problemas encontrados durante o processamento de um vídeo
disponibilidade de imagens em miniatura
sugestões para melhorar a qualidade do vídeo ou dos metadados
detalhes sobre o arquivo original enviado ao YouTube;
Todas essas partes só podem ser recuperadas pelo proprietário do vídeo. A lista a seguir descreve brevemente as novas partes, e a documentação do recurso
videodefine todas as propriedades que cada parte contém.O objeto
fileDetailscontém informações sobre o arquivo de vídeo que foi enviado ao YouTube, incluindo a resolução, a duração, os codecs de áudio e vídeo, as taxas de bits de streaming e muito mais.O objeto
processingProgresscontém 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 estimam o tempo restante até que o YouTube termine de processar o vídeo. Essa parte também indica se diferentes tipos de dados ou conteúdo, como detalhes do arquivo ou imagens em miniatura, estão disponíveis para o vídeo.Esse objeto foi projetado para ser pesquisado para que o usuário que fez o envio do vídeo possa acompanhar o progresso do YouTube no processamento do arquivo de vídeo enviado.
O objeto
suggestionscontém sugestões que identificam oportunidades para melhorar a qualidade do vídeo ou os metadados do vídeo enviado.A parte
contentDetailscontém quatro novas propriedades. Essas propriedades podem ser recuperadas com solicitações não autenticadas.dimension: indica se o vídeo está disponível em 2D ou 3D.definition: indica se o vídeo está disponível em definição padrão ou alta definição.caption: indica se as legendas estão disponíveis para o vídeo.licensedContent: indica se o vídeo tem conteúdo que foi reivindicado por um parceiro de conteúdo do YouTube.A parte
statuscontém duas novas propriedades. Os proprietários de vídeos podem definir valores para as duas propriedades ao inserir ou atualizar um vídeo. Essas propriedades também podem ser recuperadas com solicitações não autenticadas.embeddable: indica se o vídeo pode ser incorporado a outro site.license: especifica a licença do vídeo. Os valores válidos sãocreativeCommoneyoutube.
A definição do parâmetro
partfoi atualizada para os métodosvideos.list,videos.insertevideos.updatepara listar as partes recém-adicionadas, bem como a parterecordingDetails, que tinha sido omitida inadvertidamente.A nova propriedade
contentDetails.googlePlusUserIddo recursochannelespecifica o ID do perfil do Google+ associado ao canal. Esse valor pode ser usado para gerar um link para o perfil do Google+.Cada objeto de imagem de miniatura agora especifica a largura e a altura da imagem. As imagens em miniatura são retornadas nos recursos
activity,channel,playlist,playlistItem,search result,subscriptionevideo.O
playlistItems.listagora é compatível com o parâmetrovideoId, que pode ser usado com o parâmetroplaylistIdpara recuperar apenas o item da playlist que representa o vídeo especificado.A API vai retornar um erro
notFoundse o vídeo identificado pelo parâmetro não for encontrado na playlist.A documentação de erros descreve um novo erro
forbidden, que indica que uma solicitação não está devidamente autorizada para a ação solicitada.A propriedade
snippet.channelIddo recursochannelfoi removida. A propriedadeiddo recurso fornece o mesmo valor.
30 de janeiro de 2013
Esta atualização contém as seguintes alterações:
- A nova página de erros lista os erros que a API pode retornar. A página inclui erros gerais, que podem ocorrer em vários métodos de API, além de erros específicos de cada método.
16 de janeiro de 2013
Esta atualização contém as seguintes alterações:
-
Os exemplos de código agora estão disponíveis para os métodos e as linguagens mostrados na lista abaixo:
activities.insert– JavaplaylistItems.insert– PythonplaylistItems.list: Java, JavaScript, PHP, Python, Rubyplaylists.insert: Java, JavaScript, Pythonsearch.list: Java, JavaScript, Python, Rubyvideos.insert– Java
-
Um recurso
activityagora pode informar uma açãochannelItem, que ocorre quando o YouTube adiciona um vídeo a um canal gerado automaticamente. O YouTube identifica de forma algorítmica os temas que têm uma presença significativa no site e gera canais automaticamente para eles. -
Os seguintes parâmetros
search.listforam atualizados:- O parâmetro
qnão é mais designado como um filtro, o que significa que... - O parâmetro
relatedToVideofoi renomeado comorelatedToVideoId. - O parâmetro
publishedfoi substituído por dois novos parâmetros,publishedAfterepublishedBefore, descritos abaixo.
- O parâmetro
-
O método
search.listé compatível com os seguintes novos parâmetros:Nome do parâmetro Valor Descrição channelIdstringRetorna os recursos criados pelo canal especificado. publishedAfterdatetimeRetorna os recursos criados após o horário especificado. publishedBeforedatetimeRetorna os recursos criados antes do horário especificado. regionCodestringRetorna recursos para o país especificado. videoCategoryIdstringFiltra os resultados da pesquisa de vídeos para incluir apenas os vídeos associados à categoria de vídeo especificada. videoEmbeddablestringFiltra os resultados da pesquisa de vídeos para incluir apenas aqueles que podem ser reproduzidos em um player incorporado em uma página da Web. Defina o valor do parâmetro como truepara recuperar apenas vídeos que podem ser incorporados.videoSyndicatedstringFiltre os resultados da pesquisa de vídeos para incluir apenas aqueles que podem ser reproduzidos fora do YouTube.com. Defina o valor de parâmetro como truepara recuperar apenas vídeos distribuídos. -
Vários recursos da API são compatíveis com novas propriedades. A tabela abaixo identifica os recursos e as novas propriedades deles:
Recurso Nome da propriedade Valor Descrição activitycontentDetails.playlistItem.playlistItemIdstringO ID do item da playlist que o YouTube atribuiu para identificar exclusivamente o item na playlist. activitycontentDetails.channelItemobjectUm objeto que contém informações sobre um recurso que foi adicionado a um canal. Essa propriedade só vai estar presente se snippet.typeforchannelItem.activitycontentDetails.channelItem.resourceIdobjectUm objeto que identifica o recurso que foi adicionado ao canal. Como outras propriedades resourceId, ela contém uma propriedadekindque especifica o tipo de recurso, como vídeo ou playlist. Ele também contém exatamente uma das várias propriedades (videoId,playlistIdetc.) que especifica o ID que identifica exclusivamente esse recurso.channelstatusobjectEsse objeto encapsula informações sobre o status de privacidade do canal. channelstatus.privacyStatusstringO status de privacidade do canal. Os valores válidos são: privateepublic.playlistcontentDetailsobjectEsse objeto contém metadados sobre o conteúdo da playlist. playlistcontentDetails.itemCountunsigned integerO número de vídeos na playlist. playlistplayerobjectEsse objeto contém informações que você usaria para reproduzir a playlist em um player incorporado. playlistplayer.embedHtmlstringUma tag <iframe>que incorpora um player de vídeo que reproduz a playlist.videorecordingDetailsobjectEsse objeto encapsula informações que identificam ou descrevem o local e o horário em que o vídeo foi gravado. videorecordingDetails.locationobjectEsse objeto contém informações de geolocalização associadas ao vídeo. videorecordingDetails.location.latitudedoubleLatitude em graus. videorecordingDetails.location.longitudedoubleLongitude em graus. videorecordingDetails.location.elevationdoubleAltitude acima da Terra, em metros. videorecordingDetails.locationDescriptionstringUma descrição em texto do local onde o vídeo foi gravado. videorecordingDetails.recordingDatedatetimeA data e a hora em que o vídeo foi gravado. O valor é especificado no formato ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ). -
A documentação de vários métodos de API agora identifica propriedades que precisam ser especificadas no corpo da solicitação ou que são atualizadas com base em valores no corpo da solicitação. A tabela abaixo lista esses métodos e as propriedades obrigatórias ou modificáveis.
Observação: a documentação de outros métodos já pode listar propriedades obrigatórias e modificáveis.
Método Propriedades activities.insertPropriedades obrigatórias: snippet.description
snippet.descriptioncontentDetails.bulletin.resourceId
playlists.updatePropriedades obrigatórias: id
playlistItems.updatePropriedades obrigatórias: id
videos.updatePropriedades obrigatórias: id
-
A API não vai mais informar um erro
playlistAlreadyExistsse você tentar criar ou atualizar uma playlist com o mesmo título de outra que já existe no mesmo canal. -
Vários métodos de API são compatíveis com novos tipos de erro. A tabela abaixo identifica o método e os erros que agora são compatíveis:
Método Tipo de erro Detalhe do erro Descrição guideCategories.listnotFoundnotFoundNão foi possível encontrar a categoria do guia identificada pelo parâmetro id. Use o método guideCategories.list para recuperar uma lista de valores válidos.playlistItems.deleteforbiddenplaylistItemsNotAccessibleA solicitação não está devidamente autorizada a excluir o item da playlist especificado. videoCategories.listnotFoundvideoCategoryNotFoundNão foi possível encontrar a categoria de vídeo identificada pelo parâmetro id. Use o método videoCategories.list para recuperar uma lista de valores válidos.