Histórico de revisões

Esta página lista as alterações da API YouTube Data (v3) e as atualizações da documentação. Inscreva-se nesse log de mudanças.

30 de abril de 2024

Observação:este é um anúncio de descontinuação.

Esta atualização contém as seguintes alterações:

A API não oferece mais suporte à capacidade de inserir ou recuperar discussões de canais. Essa alteração é consistente com a funcionalidade disponível no site do YouTube, que não permite postar comentários em canais.

13 de março de 2024

Observação:este é um anúncio de descontinuação.

Esta atualização contém as seguintes alterações:

O parâmetro sync do captions.insert e Métodos captions.update foi descontinuado. O YouTube deixará de oferecer suporte à em 12 de abril de 2024.

Como resultado dessa mudança, os desenvolvedores precisam incluir informações de tempo ao inserir ou para atualizar as faixas de legenda ou o envio 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 informar que o tamanho máximo permitido para snippet.name tem 150 caracteres. A API retorna um nameTooLong. se o nome da faixa for maior que isso.

7 de março de 2024

Observação:este é um anúncio de descontinuação.

A propriedade de recurso channel O uso de brandingSettings.channel.moderateComments foi descontinuado. O YouTube vai parar compatíveis com o parâmetro desde 7 de março de 2024.

31 de janeiro de 2024

Esta atualização contém as seguintes alterações:

O novo forHandle do método channels.list permite que você recupere informações sobre um canal especificando seu identificador do YouTube.

9 de novembro de 2023

Todas as referências ao recurso videoId em Comments foram removidos porque o recurso videoId não está sendo retornado usando uma chamada de API.

12 de setembro de 2023

Observação:este é um anúncio de descontinuação.

Método comments.markAsSpam foi descontinuada há vários anos. Esse método já não é suportado no YouTube e não é têm mais suporte da API.

Um aviso de descontinuação foi adicionado a todos os documentos que fazem referência à comments.markAsSpam.

22 de agosto de 2023

O método search.list agora oferece suporte à videoPaidProductPlacement . Este parâmetro permite que você filtre os resultados da pesquisa para incluir apenas os vídeos que o criador de conteúdo declarou ter uma promoção paga.

18 de agosto de 2023

A definição do objeto video liveStreamingDetails.concurrentViewers foi atualizado para mostrar que as contagens de espectadores simultâneos que a API de dados do YouTube retorna podem são diferentes das contagens de espectadores simultâneos processadas e sem spam disponíveis no YouTube Análise de dados. A Central de Ajuda do YouTube fornece mais informações sobre as métricas de transmissões ao vivo.

7 de agosto de 2023

Como anunciado em 12 de junho de 2023, os search.list do método O parâmetro relatedToVideoId foi descontinuado. Esse parâmetro não é mais suportado, e as referências ao parâmetro foram removidas da documentação da API.

28 de junho de 2023

O método thumbnails.set agora é compatível com a uploadRateLimitExceeded, que indica que o canal enviou muitos itens. miniaturas nas últimas 24 horas e deve tentar novamente mais tarde.

12 de junho de 2023

Observação:este é um anúncio de descontinuação.

O método search.list O parâmetro relatedToVideoId foi descontinuado. O YouTube deixará de oferecer suporte à em 7 de agosto de 2023.

Um aviso de descontinuação foi adicionado ao método search.list na documentação do Google Cloud. Este parâmetro será totalmente removido da documentação do search.list a partir de 7 de agosto de 2023.

Além disso, um exemplo que demonstra como recuperar vídeos relacionados foi removido do guia de implementação de API.

22 de agosto de 2022

Anotações de tipo corrigidas para video.statistics de campos para string a partir de longos não assinados.

5 de agosto de 2022

O YouTube mudou a forma como os IDs de legenda são gerados e, como parte dessa mudança, atribuindo novos IDs de legenda a todas as faixas de legenda. Essa alteração pode ser um mecanismo para aplicativos que armazenam caption_id, embora não afetam aplicativos que não armazenam caption_id.

Entre hoje e 1o de dezembro de 2022, os captions.list, captions.update, captions.download e e captions.delete vão oferecem suporte para os IDs antigos e novos das faixas de legenda. No entanto, a partir de 1o de dezembro de 2022, o YouTube não será mais compatível com os IDs antigos das faixas de legenda. Nesse momento, chamar qualquer um desses métodos de API com um ID de faixa de legenda antiga resultará em um captionNotFound erro.

Para se preparar para essa mudança, planeje a substituição completa de todos os dados armazenados das faixas de legendas. até 1o de dezembro de 2022. Isso significa que, para qualquer vídeo em que você armazena uma faixa de legenda, dados, exclua os dados armazenados no momento e chame o método captions.list para recuperar o conjunto atual de faixas de legenda oculta para o vídeo e armazenar os dados na resposta da API como você faria normalmente.

12 de julho de 2022

Os Termos de Serviço das APIs do YouTube foram atualizados. Não se esqueça consulte os Termos de Serviço das APIs do YouTube - Revisão Histórico para saber mais.

27 de abril de 2022

A descrição do método videos.insert foi atualizada para informar que o tamanho máximo de arquivo para vídeos enviados aumentou de 128 GB para 256 GB.

8 de abril de 2022

O método subscriptions.list myRecentSubscribers e de parâmetros mySubscribers foram atualizados para indicar que o número máximo de assinantes retornados pela API pode ser limitado. Essa alteração representa uma correção da documentação, e não uma mudança no comportamento da API.

15 de dezembro de 2021

Conforme anunciado em 18 de novembro de 2021, junto com os mudas para marcar um vídeo como "Não gostei" a contagem é privada em toda a plataforma do YouTube, o video recurso statistics.dislikeCount agora é particular.

Saiba mais sobre essa mudança no blog oficial do YouTube.

18 de novembro de 2021

Em conjunto com as mudanças feitas tornar privadas as contagens de marcações "Não gostei" nos vídeos em toda a plataforma do YouTube, o recurso video statistics.dislikeCount se tornarão privada a partir de 13 de dezembro de 2021. Isso significa que a propriedade só incluída em uma resposta da API do endpoint videos.list se a solicitação de API tiver sido autenticado pelo proprietário do vídeo.

O endpoint videos.rate não foi afetado por essa mudança.

Desenvolvedores que não exibem a contagem de "Não gostei" publicamente e ainda precisam dessa contagem para O cliente da API pode solicitar inclusão em uma lista de permissões para receber uma isenção. Para solicitar uma isenção, faça o seguinte: deve concluir formulário de inscrição.

Saiba mais sobre essa mudança no blog oficial do YouTube.

2 de julho de 2021

Observação:este é um anúncio de descontinuação.

O endpoint commentThreads.update foi descontinuado e não recebe mais suporte. Esse endpoint duplicou a funcionalidade disponível por meio de outros endpoints da API. Em vez disso, você pode chamar comments.update

método 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 passar por uma auditoria de conformidade para receberem mais do que a alocação de cota padrão de 10.000 unidades. Até o momento, o processo de auditoria de conformidade e as solicitações de alocações adicionais de unidades de cota foram conduzidos pelos desenvolvedores que preencheram e enviaram o Formulário de auditoria e extensão de cota da API 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 o preenchimento deles:

• Formulário de solicitações de desenvolvedor auditado: os desenvolvedores que já foram aprovados em uma auditoria de conformidade da API podem preencher e enviar este formulário mais curto para solicitar uma extensão de cota alocada.
• Formulário de contestação: os desenvolvedores cujos projetos de API foram reprovados em uma auditoria de conformidade ou tiveram um aumento de unidade de cota negado podem preencher e enviar esse formulário.
• Formulário de mudança de controle: os desenvolvedores ou qualquer parte que operar um cliente de API em nome de um desenvolvedor e sofrer uma mudança de controle (por exemplo, por 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 ajudar da melhor forma possível.

Confira mais detalhes no novo guia de auditorias de compliance da API.

12 de maio de 2021

Observação:este é um anúncio de descontinuação.

Esta atualização abrange as seguintes mudanças na API:

• O objeto channel contentDetails.relatedPlaylists.favorites foi descontinuada. A funcionalidade de vídeos favoritos já foi descontinuada para vários anos, conforme observado na revisão 28 de abril de 2016 entrada do histórico.

  Antes desta atualização, a API ainda criava uma nova lista de reprodução se um cliente da API tentasse adicionar um vídeo a uma lista de reprodução de favoritos inexistente. A partir de agora, a playlist não será criado nesse caso, e a API retornará um erro. Tentativas de modificar listas de reprodução favoritas adicionar, modificar ou excluir itens também foram descontinuados, de acordo com avisos anteriores. pode começar a retornar erros a qualquer momento.

• O recurso channel a seguir foram descontinuadas. Estas propriedades já não são compatíveis com a interface do YouTube Studio e no YouTube. Como resultado, eles também não são mais suportados pela API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Todas as propriedades foram removidas da channel representação de recurso, e suas definições foram removidas do lista de propriedades. Além disso, os erros associadas a essas propriedades foram removidas da documentação específica dos métodos.

• O recurso channelSection a seguir foram descontinuadas. Estas propriedades já não são compatíveis com a interface do YouTube Studio e no YouTube. Como resultado, eles também não são mais suportados pela API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  Em conjunto com essa mudança, o método channelSection.list O parâmetro hl também tem foi descontinuado porque os recursos com suporte não são compatíveis.

  Todas as propriedades foram removidas da channelSection representação de recurso, e suas definições foram removidas do lista de propriedades. Além disso, os erros associadas a essas propriedades foram removidas da documentação específica dos métodos.

• Para o URL do recurso channelSection, propriedade snippet.type, os valores a seguir foram descontinuados. Esses valores já não são aceitos no YouTube páginas de canal e, como resultado, elas também não são mais suportadas pela API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• O objeto playlist A propriedade snippet.tags[] foi descontinuada. Esta propriedade já não é compatível no YouTube e, por isso, não recebe mais suporte pela API.

9 de fevereiro de 2021

O recurso playlistItem é compatível com duas novas propriedades:

• O snippet.videoOwnerChannelId identifica o ID do canal que enviou o vídeo da playlist.
• O snippet.videoOwnerChannelTitle identifica o nome do canal que enviou o vídeo da lista de reprodução.

28 de janeiro de 2021

Esta atualização contém as seguintes alterações:

• O playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list e Todos os métodos playlists.update têm suporte um novo erro playlistOperationUnsupported. O erro ocorre quando uma solicitação tenta executar uma operação não permitida para uma lista de reprodução específica. Por exemplo, um usuário não pode excluir um vídeo da lista de reprodução de vídeos enviados ou excluir a própria lista de reprodução.

  Em todos os casos, esse erro retorna um código de resposta HTTP 400 (solicitação inválida).

• O método playlistItems.list Os erros watchHistoryNotAccessible e watchLaterNotAccessible foram removidos da documentação. Enquanto as variáveis o histórico de exibição e as listas Assistir mais tarde não acessíveis por meio da API, esses erros específicos não são retornados pela API.

15 de outubro de 2020

Duas novas seções foram adicionadas à guia Lista Políticas:

• A nova Seção III.E.4.i estabelece informações adicionais sobre os dados coletados e enviados pelo player incorporado do YouTube. Você são responsáveis por quaisquer dados de usuário que você nos enviar por meio de qualquer player incorporado do YouTube antes da o usuário interagiu com o player para indicar a intenção de reprodução. Você pode limitar os dados compartilhados ao YouTube antes de um usuário interagir com o player ao definir a Reprodução automática como falsa.
• A nova Seção III.E.4.j se refere verificar o status do conteúdo para crianças (MFK) antes de incorporá-lo aos seus sites; e apps. Você é responsável por saber quando os vídeos incorporados ao Cliente da API são feitos para crianças e tratando adequadamente os dados coletados do player incorporado. Por isso, você precisa Verificar o status do conteúdo usando o serviço da API YouTube Data antes de incorporá-lo à sua API por qualquer player incorporado do YouTube.

Novo Como encontrar o status MadeForKids de um vídeo explica como procurar o status de conteúdo para crianças (MFK) de um vídeo usando o Serviço da API YouTube Data.

Em conjunto com essas alterações, um lembrete foi adicionado ao Documentação do parâmetro do player incorporado para explicar que se você ativar a Reprodução automática, a reprodução ocorrerá sem qualquer interação do usuário com o player. reprodução A coleta e o compartilhamento de dados ocorrem no momento do carregamento da página.

8 de outubro de 2020

Essa atualização abrange três pequenas mudanças relacionadas à Recurso channel:

• O snippet.thumbnails que identifica as imagens em miniatura de um canal, pode estar vazio para objetos recém-criados canais e pode levar até um dia para ser preenchido.
• O statistics.videoCount mostra somente o número de vídeos públicos do canal, mesmo para os proprietários. Esse comportamento é consistente com as contagens exibidas no site do YouTube.
• As palavras-chave do canal, que são identificadas na brandingSettings.channel.keywords , poderão ser truncados se excederem o tamanho máximo permitido de 500 caracteres ou se continham aspas sem escape ("). O limite de 500 caracteres não é um limite por palavra-chave, mas um limite no comprimento total de todas as palavras-chave. Esse comportamento é consistente com o do site do YouTube.

9 de setembro de 2020

Observação:este é um anúncio de descontinuação.

Esta atualização abrange as seguintes mudanças na API. Todas as mudanças vão entrar em vigor em ou após essa data 9 de setembro de 2020, a data deste anúncio. Com isso em mente, os desenvolvedores não devem mais dependem de algum dos recursos de API listados abaixo.

• Os seguintes recursos, métodos, parâmetros e propriedades da API foram descontinuados imediatamente e deixará de funcionar a partir da data deste aviso:
  • O recurso channel a seguir propriedades:
    • A propriedade statistics.commentCount
    • O objeto brandingSettings.image e todas as propriedades filhas dele
    • A lista brandingSettings.hints e todas as propriedades filhas
  • O método channels.list Parâmetro de filtro categoryId
  • O recurso guideCategories e o guideCategories.list método
• Respostas de API para os Não do método channels.list já contêm o prevPageToken propriedade se a solicitação da API definir o Parâmetro managedByMe para true. Essa mudança não afeta a propriedade prevPageToken para outras solicitações channels.list e não afeta o nextPageToken para as solicitações.
• O contentDetails.relatedPlaylists.watchLater do recurso channel e contentDetails.relatedPlaylists.watchHistory propriedades foram anunciadas tiveram o uso suspenso em 11 de agosto de 2016. A Suporte aos métodos playlistItems.insert e playlistItems.delete para essas playlists também foram totalmente descontinuadas, e as duas propriedades foram removidas da documentação.
• O parâmetro mySubscribers do método channels.list, que foi anunciado como descontinuado em 30 de julho de 2013, foi removido da documentação. Use o subscriptions.list e o parâmetro mySubscribers para recuperar uma lista de assinantes do canal do usuário autenticado.
• O objeto invideoPromotion do recurso channel e todos os filhos dele propriedades, 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 cotas para solicitações de API removendo as custo associado ao parâmetro part. Com efeito imediato, cobraremos apenas o custo base do método chamado. Encontre mais informações sobre o cota aqui.

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 APIs chamadas. No geral, o impacto provável é que sua cota alocada, que pode ser vista no Console do Google Cloud, você irá um pouco mais além.

Recomendamos que todos os desenvolvedores concluam uma auditoria de compliance para a projetos para garantir o acesso contínuo aos serviços de API do YouTube.

Esta entrada do histórico de revisões foi publicada originalmente em 20 de julho de 2020.

28 de julho de 2020

Todos os vídeos enviados por videos.insert de projetos de API não verificados criados após 28 de julho de 2020 ficará restrito a o modo de visualização particular. Para remover essa restrição, cada projeto precisa passar por uma auditoria para verificar conformidade com as 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 isso. o vídeo será bloqueado como privado e poderá ser evitado com a ajuda ou auditado.

Os projetos de API criados antes de 28 de julho de 2020 estão não serão afetadas por essa mudança no momento. No entanto, recomendamos que todos os desenvolvedores concluir uma auditoria de compliance dos projetos para garantir o acesso contínuo aos serviços de API do YouTube.

21 de julho de 2020

[Atualizado em 28 de julho de 2020.] A atualização da documentação mencionada nesta revisão o histórico foi republicado em 28 de julho de 2020.

Ontem, publicamos uma atualização da documentação relacionada ao nosso processo de cobrança de cotas. No entanto, devido a circunstâncias imprevistas, a alteração de cota ainda não está em vigor. Como resultado, a documentação foi revertida para fins de precisão. Para evitar confusão, a revisão histórico explicando a alteração foi removido e será republicado em breve.

7 de julho de 2020

Observação:este é um anúncio de descontinuação.

O método videos.insert Os parâmetros autoLevels e stabilize foram descontinuados, e ambos parâmetros foram removidos da documentação. Seus valores são ignorados e não afetam o maneira como os vídeos enviados recentemente são processados.

15 de junho de 2020

A nova seção Conformidade com o Desenvolvedor do YouTube Políticas fornecem orientação e exemplos para ajudar você a garantir que seus clientes de API sigam a partes específicas dos serviços da API do YouTube Termos e Políticas (TOS da API).

Essas orientações oferecem insights sobre como o YouTube aplica certos aspectos dos TOS da API, mas não não substituir os documentos existentes. O guia aborda algumas das perguntas mais comuns que dos desenvolvedores durante auditorias de conformidade de API. Esperamos que isso simplifique o desenvolvimento de recursos ajudando você a entender como interpretamos e aplicamos nossas políticas.

4 de junho de 2020

Observação:esta é uma atualização de um anúncio anterior de descontinuação.

O uso do recurso de boletim de canais foi totalmente suspenso. 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" não há mais suporte, activities.list não retorna mais boletins de canais. Para mais detalhes, consulte a Central de Ajuda do YouTube.

17 de abril de 2020

Observação:este é um anúncio de descontinuação.

O YouTube vai descontinuar o recurso de boletim de canais. Como resultado, O método activities.insert será descontinuada, e a activities.list interrompe o retorno de boletins de canal. Essas mudanças vão entrar em vigor na API em ou após 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 member representa uma membro de um canal do YouTube. Um membro oferece suporte monetário recorrente a um criador de conteúdo e recebe benefícios especiais. Por exemplo, os membros podem bater papo quando o ativa o modo exclusivo para membros no chat.

    Esse recurso substitui o sponsor recurso, que é documentado como parte da API de transmissão do YouTube ao vivo. A O recurso sponsor foi descontinuado, e os clientes de API precisam atualizar as chamadas para método sponsors.list para usar members.list.

  • O novo membershipsLevel recurso identifica um nível de preço gerenciado pelo criador que autorizou a solicitação de API. O membershipsLevels.list recupera uma lista de todos os níveis de associação do criador.

10 de janeiro de 2020

A API agora oferece suporte à capacidade de identificar conteúdo feito para crianças, que o YouTube chama "conteúdo para crianças". Saiba mais sobre "conteúdo para crianças" na Central de Ajuda do YouTube.

Os métodos channel e Os recursos video oferecem suporte a duas novas propriedades para permitem que criadores e espectadores identifiquem conteúdo para crianças:

• A propriedade selfDeclaredMadeForKids permite que os criadores de conteúdo especifiquem se um channel ou vídeo foi classificado como conteúdo para crianças.
  
  Para canais, esta propriedade pode ser definida ao chamar o channels.update. Para vídeos, essa propriedade pode ser definida ao chamar o videos.insert ou videos.update.
  
  Observe que essa propriedade só é incluída em respostas da API que contenham channel ou Recursos video se o proprietário do canal tiver autorizado a solicitação de API.
• A propriedade madeForKids permite que qualquer usuário recupere o conteúdo para crianças Status de um canal ou vídeo. Por exemplo, o status pode ser determinado com base no valor da propriedade selfDeclaredMadeForKids. Consulte a Central de Ajuda do YouTube para mais informações informações sobre como definir o público de seu canal, vídeos ou transmissões.

Também atualizamos os Termos de Serviço e as políticas para desenvolvedores das APIs do YouTube. Não se esqueça consulte os Termos de Serviço das APIs do YouTube - Revisão Histórico para saber mais. As mudanças nos Termos de Serviço das APIs do YouTube e As políticas para desenvolvedores entrarão 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 o assinante contagens 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 três números para contagens de inscritos superiores a 1.000 inscritos. Essa mudança afeta channel de recursos statistics.subscriberCount .

Observação:essa mudança afeta o valor da propriedade mesmo nos casos em que um usuário envia uma solicitação autorizada de dados sobre o próprio canal. Os proprietários de canais ainda podem ver as contagens de inscritos no YouTube Studio.

Por exemplo, se um canal tem 123.456 inscritos, A propriedade statistics.subscriberCount conterá o valor 123000. A tabela abaixo mostra exemplos de como as contagens de inscritos são arredondadas nas respostas da API e abreviada em outras interfaces de 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 para fornecer exemplos de código dinâmicos e de alta qualidade por meio do widget do APIs Explorer. Consulte a documentação do método channels.list para conferir um exemplo. Agora, há dois novos elementos nas páginas que descrevem os métodos da API:

  • Com o widget do APIs Explorer, é possível selecionar escopos de autorização, inserir exemplos de valores de parâmetros e propriedades, enviar solicitações de API reais e ver as respostas reais da API. 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.list para recuperar dados sobre um canal específico ou sobre o canal do usuário atual.

    Você pode usar links nessa seção para preencher o APIs Explorer com exemplos de valores para seu caso de uso ou 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 diretamente aplicáveis ao caso de uso que você está tentando implementar no próprio aplicativo.

  No momento, 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 IU que oferece os mesmos recursos descritos acima. Com essa ferramenta, você pode explorar casos de uso para diferentes métodos, carregar valores no APIs Explorer e abrir o APIs Explorer em tela cheia para obter exemplos de código em Java, JavaScript, PHP e Python.

  Além dessa mudança, as páginas que anteriormente 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 exemplo com um ID de cliente OAuth 2.0 usando exemplos de código do APIs Explorer.

As mudanças descritas acima 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.thumbnails do recurso channel foi atualizada para observar que, ao exibir miniaturas no aplicativo, seu código precisa usar os URLs de imagem exatamente como são retornados nas respostas da API. Por exemplo, o aplicativo não deve usar o domínio http em vez do domínio https em um URL retornado em uma resposta da API.

  A partir de julho de 2018, os URLs das miniaturas de canais só estarão disponíveis no domínio https, que é como os URLs aparecem nas respostas da API. Após esse período, você poderá ver imagens corrompidas em seu aplicativo se ele tentar carregar imagens do YouTube a partir do domínio http.

• Observação:este é um anúncio de descontinuação.

  A propriedade recordingDetails.location.altitude do recurso video foi descontinuada. Não há garantia de que os vídeos retornarão valores para essa propriedade. Da mesma forma, mesmo se as solicitações da API tentarem definir um valor para essa propriedade, é possível que os dados de entrada não sejam armazenados.

22 de junho de 2018

O Guia de implementação, anteriormente conhecido como de implementação e migração, foi atualizado para remover instruções de migração da para a v3. Além disso, também foram removidas instruções para recursos que desde que foram descontinuados na API v3, como os vídeos favoritos.

27 de novembro de 2017

Esta atualização contém as seguintes alterações:

• Observação:este é um anúncio de descontinuação.

  O YouTube está removendo o suporte para os recursos Vídeo em destaque e Site em destaque, que têm suporte na API pelo objeto invideoPromotion do recurso channel. Como resultado, o uso desse objeto, incluindo todas as suas propriedades filhas, está sendo suspenso.

  Você ainda pode recuperar e definir dados do invideoPromotion até 14 de dezembro de 2017. Depois dessa data:

  • As tentativas de recuperar a parte de invideoPromotion ao chamar channels.list retornarão uma invideoPromotion vazia ou não retornarão nenhum dado de invideoPromotion.
  • As tentativas de atualizar dados de invideoPromotion ao chamar channels.update retornarão uma resposta bem-sucedida, no mínimo, até 27 de maio de 2018, mas serão tratadas como ambiente autônomo, o que significa que elas não realizarão uma atualização.

  Desde 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 amostras de código Node.js. Os exemplos também podem ser consultados na documentação de quase todos os métodos da 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, os exemplos contêm algumas funções utilitárias que não aparecem no guia de início rápido:

  • A função removeEmptyParameters recebe uma lista de pares de chave-valor correspondentes aos parâmetros de solicitação da API e remove os parâmetros que não têm valores.
  • A função createResource recebe uma lista de pares de chave-valor correspondentes às propriedades de um recurso da API. Em seguida, ele converte as propriedades em um objeto JSON que pode ser usado em operações insert e update. O exemplo abaixo mostra um conjunto de nomes e valores de propriedades 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'
     }
    }

  Todos esses exemplos foram projetados para download e execução local. Para mais informações, consulte os pré-requisitos para executar amostras de código completas 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-auth e google-auth-oauthlib em vez da biblioteca oauth2client, 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 ligeiramente diferentes. Para ver os exemplos completos (e essa alteração):

  1. Acesse a ferramenta interativa de snippet de código ou a documentação de qualquer método de API, como channels.list.
  2. Clique na guia Python acima dos exemplos de código.
  3. Clique no botão acima das guias para mudar a visualização de um snippet para uma amostra completa.
     
  4. A guia vai mostrar 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 vincula a uma amostra de aplicativo de servidor da Web.
  5. Clique no link para acessar o exemplo do servidor da Web. Esse exemplo usa o framework de aplicativo da Web Flask e um fluxo de autorização diferente.

  Todos esses exemplos foram projetados para download e execução local. Se você quiser executar as amostras, consulte as instruções para executar amostras de código completas localmente nas instruções da ferramenta de snippet de código.

29 de agosto de 2017

Esta atualização contém as seguintes alterações:

• A definição do parâmetro forContentOwner do método search.list foi atualizada para informar que, se esse parâmetro for definido como true, o parâmetro type precisará ser definido como video.
• A definição do parâmetro regionCode do método search.list foi atualizada para esclarecer que o parâmetro restringe os resultados da pesquisa a vídeos que podem ser assistidos na região especificada.
• Os logotipos e ícones da marca do YouTube foram atualizados. Novo conteúdo "desenvolvido com o YouTube" Faça o download dos logotipos na página Diretrizes de branding. Outros logotipos e ícones novos do YouTube também são mostrados nessa página, e você pode fazer o download deles no Site da marca 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 de dados do YouTube em um aplicativo iOS simples escrito em Objective-C ou Swift.
• A ferramenta de snippet de código interativo da API YouTube Data agora inclui uma 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)

  Observação:a ferramenta também está incorporada na documentação de referência da API para métodos (exemplo).

1º de junho de 2017

Esta atualização contém as seguintes alterações:

• Observação:este é um anúncio de descontinuação.

  As seguintes propriedades de recurso video estão sendo descontinuadas. As propriedades serão compatíveis até 1o de dezembro de 2017, mas não há garantia de que os vídeos continuarão retornando valores para essas propriedades até essa data. Da mesma forma, as solicitações videos.insert e videos.update que 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.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

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.list ou videos.rate, agora apresentam 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.list para 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:

  • Se você modificar os valores de parâmetros e propriedades, os snippets de código serão atualizados dinamicamente para refletir os valores fornecidos.

  • Alterne 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. Uma amostra completa contém esse snippet, bem como um código boilerplate para autorização e envio de 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, você precisa autorizar a ferramenta a chamar a API em seu nome.

  Essa ferramenta substituiu o APIs Explorer nas páginas em que estava 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 descritos acima. Os principais recursos novos disponíveis nessa página são:

  • Suporte a solicitações de API que gravam dados.
  • Suporte a exemplos de 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 simples que faz solicitações da API YouTube Data. No momento, 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 recurso channel contém uma lista de URLs da Wikipédia que descrevem o conteúdo do canal. Os URLs correspondem aos IDs dos temas retornados na propriedade topicDetails.topicIds[] do recurso.
• A nova propriedade contentDetails.videoPublishedAt do recurso playlistItem identifica a hora em que o vídeo foi publicado no YouTube. O recurso já contém a propriedade snippet.publishedAt, que identifica a hora em que o item foi adicionado à playlist.
• Assim como o recurso channel, o recurso video agora retorna a propriedade topicDetails.topicCategories[], que contém uma lista de URLs da Wikipédia que descrevem o conteúdo do vídeo. Para recursos video, os URLs correspondem aos IDs de tópicos retornados na propriedade topicDetails.relevantTopicIds[] do recurso.
• A nova propriedade contentDetails.contentRating.mpaatRating do recurso video identifica a classificação que a Motion Picture Association of America deu ao trailer ou prévia de um filme.

27 de fevereiro de 2017

Conforme anunciado originalmente em 11 de agosto de 2016, o YouTube mudou a lista compatível de IDs de tópicos 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/09s1f
  Saúde	/m/0kt51
  Militar	/m/01h6rj
  Política	/m/05qt0
  Religião	/m/06bvp

• O tópico Animated cartoon, anteriormente filho de Entertainment, foi removido.
• O tópico Children's music, anteriormente filho de Music, foi removido.

Como resultado dessa mudança, os temas relacionados a um vídeo agora são sempre retornados no valor de propriedade topicDetails.relevantTopicIds[] do recurso video.

29 de novembro de 2016

Esta atualização contém as seguintes alterações:

• Há três pequenas alterações na lista de IDs de tópicos que terão suporte a partir de 10 de fevereiro de 2017:

  • A categoria Professional wrestling, que antes era filha da categoria Sports, agora é filha de Entertainment.
  • A categoria TV shows, filha de Entertainment, é nova.
  • A categoria Health, anteriormente filha de Lifestyle, foi removida.

  Há algumas categorias principais (Entertainment, Gaming, Lifestyle, Music e Sports). Qualquer vídeo associado a uma categoria secundária, como Tennis, também será associado à categoria principal (Sports).

10 de novembro de 2016

Esta atualização contém as seguintes alterações:

• Conforme anunciado pela primeira vez em 11 de agosto de 2016, a descontinuação do Freebase e da API Freebase requer várias mudanças relacionadas aos IDs de tópicos. Os IDs de tópicos identificam temas associados aos recursos do channel e video, e você também pode usar o parâmetro de pesquisa topicId para encontrar canais ou vídeos relacionados a um tema específico.

  Em 10 de fevereiro de 2017, o YouTube começará a retornar um pequeno conjunto de IDs de tópicos em vez de um conjunto muito mais granular de IDs retornados até o momento. Além disso, não há garantia de que os canais e vídeos serão associados a qualquer tópico, o que é consistente com o comportamento atual da API.

  Para que você possa preparar seus clientes da API para essas mudanças, as definições dos parâmetros e das propriedades da API a seguir foram atualizadas para listar os IDs de tópicos que terão suporte após esse período. A lista de categorias é a mesma para todas as propriedades.

  • A propriedade topicDetails.topicIds[] do recurso channel.
  • A propriedade topicDetails.relevantTopicIds[] do recurso video.
  • O parâmetro topicId do método search.list.

• Observação:este é um anúncio de descontinuação.

  As seguintes propriedades estão sendo descontinuadas:

  • A propriedade topicDetails.topicIds[] do recurso channel. Esta propriedade será compatível até 10 de novembro de 2017.
  • A propriedade topicDetails.relevantTopicIds[] do recurso video. Esta propriedade será compatível até 10 de novembro de 2017.
  • A propriedade topicDetails.topicIds[] do recurso video. Essa propriedade não terá valores posteriores a 10 de fevereiro de 2017. Após essa data, o valor da propriedade topicDetails.relevantTopicIds[] identificará todos os temas associados a um vídeo.

• Como o Freebase já foi descontinuado, o guia Como pesquisar 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 tópicos 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 video contém várias propriedades novas:

    • A propriedade player.embedHtml contém uma tag <iframe> que pode ser usada para incorporar um player que reproduz o vídeo. As novas propriedades player.embedHeight e player.embedWidth identificam 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âmetros maxHeight ou maxWidth. Esses dois novos parâmetros são explicados posteriormente nesta entrada do histórico de revisões.

    • A nova propriedade hasCustomThumbnail indica se o usuário que fez o envio forneceu uma imagem de miniatura personalizada para o vídeo. Essa propriedade só é visível para o usuário que fez o envio do vídeo.

    • O novo fpbRatingReasons[] identifica os motivos pelos quais o vídeo recebeu a classificação em FPB (África do Sul).

    • O novo mcstRating identifica a classificação que o vídeo recebeu no Vietnã.

  • O método videos.list é compatível com dois novos parâmetros, maxHeight e maxWidth. É possível usar um dos parâmetros ou ambos ao recuperar a parte player nos recursos video.

    Por padrão, a altura do <iframe> retornado na propriedade player.embedHtml é de 360 px. A largura é ajustada para corresponder à proporção do vídeo, garantindo que o player incorporado não tenha barras pretas enquadrando 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, você pode especificar que, em vez das dimensões padrão, o código de incorporação deve usar uma altura e/ou largura adequada para o layout do seu aplicativo. O servidor da API dimensiona as dimensões do player conforme apropriado para garantir que o player incorporado não tenha barras pretas enquadrando o vídeo. Ambos os 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 do 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.embedHtml conteria um player de 640 x 360 se o parâmetro maxHeight ou maxWidth não estiver definido.

    • Se o parâmetro maxHeight for definido como 720 e o parâmetro maxWidth não estiver definido, a API vai retornar um player de 1280 x 720.
    • Se o parâmetro maxWidth for definido como 960 e o parâmetro maxHeight não estiver definido, a API vai retornar um player de 960 x 540.
    • Se o parâmetro maxWidth for definido como 960 e o parâmetro maxHeight estiver definido como 450, a API vai retornar um player de 800 x 450.

    As novas propriedades player.embedHeight e player.embedWidth, descritas acima, identificam as dimensões do player.

• Atualizações de métodos, propriedades e parâmetros atuais

  • A descrição do recurso channelSection foi atualizada para informar que um canal pode criar, no máximo, 10 seções sem definir dados de segmentação e criar, no máximo, 100 seções com dados.

    Além disso, a propriedade targeting do recurso channelSection foi 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 na interface do usuário no site do YouTube.

  • A definição da propriedade snippet.name do recurso i18nLanguage foi corrigida para refletir que o valor representa o nome de um idioma da forma como é escrito no idioma especificado pelo parâmetro hl do método i18nLanguage.list.

  • A propriedade contentDetails.note do recurso playlistItem foi atualizada para informar que o comprimento máximo do valor da propriedade é de 280 caracteres.

  • As propriedades contentDetails.startAt e contentDetails.endAt do recurso playlistItem foram descontinuadas. Esses campos serão ignorados se forem definidos em solicitações playlistItems.insert ou playlistItems.update.

  • Os métodos playlistItems.delete e playlistItems.update agora aceitam o parâmetro onBehalfOfContentOwner, 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 escopo https://www.googleapis.com/auth/youtubepartner.

  • Os parâmetros publishedBefore e publishedAfter do método search.list foram atualizados para indicar que os valores são inclusivos. Por exemplo, se o parâmetro publishedBefore estiver definido, a API vai retornar recursos criados antes ou no momento especificado.

  • A propriedade contentDetails.contentRating.grfilmRating do recurso video é compatível com três outros valores: grfilmK12, grfilmK15 e grfilmK18.

  • A descrição do método videos.insert foi atualizada para informar que o tamanho máximo de arquivo para vídeos enviados aumentou de 64 GB para 128 GB.

• Erros novos e atualizados

  • A API oferece suporte aos seguintes erros novos:

    Tipo de erro	Detalhe do erro	Descrição
    forbidden (403)	homeParameterDeprecated	O método activities.list retorna esse erro para indicar que os dados de atividade na página inicial do usuário não estão disponíveis por essa API. Esse erro poderá ocorrer se você definir o parâmetro home como true em uma solicitação não autorizada.
    invalidValue (400)	invalidContentDetails	O método playlistItems.insert retorna esse erro para indicar que o objeto contentDetails na solicitação é inválido. Esse erro ocorre porque o campo contentDetails.note tem mais de 280 caracteres.
    forbidden (403)	watchHistoryNotAccessible	O método playlistItems.list retorna esse erro para indicar que a solicitação tentou recuperar o "histórico de exibição" itens da playlist, mas eles não podem ser recuperados usando a API.
    forbidden (403)	watchLaterNotAccessible	O método playlistItems.list retorna esse erro para indicar que a solicitação tentou recuperar "assistir mais tarde" itens da playlist, mas eles não podem ser recuperados usando a API.
    badRequest (400)	uploadLimitExceeded	O método videos.insert retorna esse erro para indicar que o canal excedeu o número de vídeos que pode ser enviado.
    forbidden (403)	forbiddenEmbedSetting	O método videos.update retorna esse erro para indicar que a solicitação da 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 para transmissões ao vivo. Acesse a Central de Ajuda do YouTube para mais informações.

  • O método playlistItems.insert não retorna mais um erro se você inserir um vídeo duplicado em uma playlist. Esse erro ocorreu anteriormente para algumas playlists, como vídeos favoritos, que não permitiam cópias, mas não são mais compatíveis. Em geral, as playlists permitem cópias de vídeos.

• 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.watchHistory e contentDetails.relatedPlaylists.watchLater do recurso channel forem incluídas em uma resposta, elas sempre vão conter os valores HL e WL, respectivamente. Além disso, essas propriedades só serão incluídas se um usuário autorizado estiver recuperando dados sobre o próprio canal do usuário.

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 será alterado a partir de 10 de fevereiro de 2017. A lista de tópicos que serão compatíveis será publicada até 10 de novembro de 2016.

• As seguintes mudanças já estão em vigor. Um aviso sobre essas alterações foi enviado na atualização do histórico de revisões em 11 de agosto de 2016:

  • Se o método activities.list for chamado com o parâmetro home definido como true, a resposta da API agora conterá itens semelhantes aos que um usuário do YouTube desconectado veria na página inicial.

    Esta é uma pequena alteração destinada a proporcionar uma melhor experiência do usuário do que o comportamento descrito na atualização do histórico de revisões em 11 de agosto de 2016. Essa atualização indicou que as solicitações que usam o parâmetro home retornariam uma lista vazia.

  • As propriedades contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater do recurso channel agora contêm valores de HL e WL, respectivamente, para todos os canais.

    Para deixar claro, essas propriedades só ficam visíveis para um usuário autorizado que recupera dados sobre o próprio canal do usuário. As propriedades sempre contêm os valores HL e WL, mesmo para um usuário autorizado recuperando dados sobre o próprio canal do usuário. Portanto, os IDs do histórico de exibição e da playlist Assistir mais tarde não podem ser recuperados pela API.

    Além disso, as solicitações para recuperar detalhes da playlist (playlists.list) ou itens da playlist (playlistItems.list) referentes ao histórico de exibição ou à playlist "Assistir mais tarde" de um canal agora retornam listas vazias. Esse comportamento é válido para os novos valores, HL e WL, assim como para qualquer ID do histórico de exibição ou da playlist "Assistir mais tarde" que seu cliente da API já tenha armazenado.

• O objeto fileDetails.recordingLocation do recurso video e as propriedades filhas dele não são mais retornados. Antes, esses dados, assim como o objeto fileDetails pai, 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 novos Termos de Serviço dos serviços de API do YouTube ("Termos atualizados"), discutidos em detalhes no Blog de engenharia e desenvolvedores do YouTube (em inglês), oferecem um conjunto completo de atualizações dos Termos de Serviço atuais. Além dos Termos atualizados, que entrarão em vigor em 10 de fevereiro de 2017, esta atualização inclui vários documentos de apoio para ajudar a explicar as políticas que os desenvolvedores precisam seguir.

  O conjunto completo dos novos documentos está descrito no histórico de revisões dos Termos atualizados. Além disso, futuras alterações nos Termos atualizados ou nesses documentos de comprovação também serão explicadas no histórico de revisões. Você pode se inscrever em um feed RSS listando as alterações do histórico de revisões por um link no documento.

• 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 da API:

  • A parte topicDetails do recurso channel identifica os temas associados ao canal.
  • A parte topicDetails do recurso video identifica os temas associados ao vídeo.
  • O parâmetro topicId do método search.list permite pesquisar vídeos ou canais relacionados a um tema específico.

  Estas são as mudanças nesses recursos:

  • A partir de 10 de fevereiro de 2017, o YouTube começará a retornar um pequeno conjunto de IDs de tópicos em vez de um conjunto muito mais granular de IDs retornados até o momento. Esse conjunto de temas aceitos vai identificar categorizações gerais, como Esportes ou Basquete, mas, por exemplo, não vai identificar times ou jogadores específicos. Anunciaremos o conjunto de tópicos compatíveis para que você tenha tempo de preparar sua inscrição para essa mudança.

  • Qualquer ID de tópico do Freebase que você já tiver recuperado pode ser usado para pesquisar conteúdo até 10 de fevereiro de 2017. Após esse período, você poderá usar apenas o conjunto menor de temas identificados no item anterior para recuperar os resultados da pesquisa por tema.

  • Depois de 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ópico compatíveis, a API retornará um conjunto de resultados vazio.

• Vários campos e parâmetros de API serão suspensos a partir de 12 de setembro de 2016:

  • O parâmetro home do método activities.list permitiu 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 retornarão uma lista vazia.

  • As propriedades contentDetails.relatedPlaylists.watchHistory e contentDetails.relatedPlaylists.watchLater do recurso channel são visíveis apenas para um usuário autorizado que recupera dados sobre o próprio canal do usuário. Após 12 de setembro de 2016, o contentDetails.relatedPlaylists.watchHistory retornará um valor de HL e a propriedade contentDetails.relatedPlaylists.watchLater retornará um valor de WL para todos os canais.

    As solicitações para recuperar detalhes da playlist (playlists.list) referentes ao histórico de exibição ou à playlist "Assistir mais tarde" de um canal retornarão uma lista vazia após 12 de setembro de 2016. As solicitações para recuperar itens da playlist (playlistItems.list) em qualquer uma dessas playlists também vão retornar uma lista vazia após esse período. Isso é verdadeiro para os novos valores, HL e WL, assim como para qualquer ID do histórico de exibição ou da playlist "Assistir mais tarde" que seu cliente da API já tenha armazenado.

  • O objeto fileDetails.recordingLocation do recurso video ou qualquer uma das propriedades filhas dele não será mais retornado depois de 12 de setembro de 2016. Esses dados só podem ser recuperados pelo proprietário de um vídeo, uma vez que o objeto fileDetails pai só pode ser recuperado por um proprietário do vídeo.

13 de junho de 2016

Esta atualização contém as seguintes alterações:

• A propriedade contentDetails.googlePlusUserId do recurso channel foi 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 recurso channel.

• A propriedade snippet.authorGoogleplusProfileUrl do recurso comment foi 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 recurso comment.

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 myRecentSubscribers do método subscriptions.list recupera uma lista de inscritos do canal do usuário autenticado em ordem cronológica inversa da hora em que se inscreveu no canal.

  O novo parâmetro só oferece suporte à recuperação dos últimos mil inscritos 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 assinantes em uma ordem específica, não limita o número de assinantes que podem ser recuperados.

• A definição da propriedade snippet.thumbnails.(key) foi atualizada para os recursos activity, playlistItem, playlist, resultado da pesquisa, miniatura e vídeo para observar que outros tamanhos de imagem de miniatura estão disponíveis para alguns vídeos.

  • A imagem standard tem 640 px de largura e 480 px de altura.
  • A imagem maxres tem 1.280 px de largura e 720 px de altura.

• A definição do parâmetro part do método channelSection.list foi atualizada para informar que a parte targeting pode ser recuperada a um custo de 2 unidades de cota.

• O método videos.list agora retorna um erro proibido (403) quando uma solicitação autorizada incorretamente tenta recuperar as partes fileDetails, processingDetails ou suggestions de um recurso video. 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. No momento, os snippets de código estão disponíveis para todos os métodos de API somente leitura em 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 exibe os parâmetros usados na solicitação de API. Você pode modificar os valores dos parâmetros. Nesse caso, a ferramenta atualizará os snippets de código para refletir os valores de parâmetros fornecidos.

Por fim, a ferramenta exibe a resposta da API para cada solicitação. Se você modificou os parâmetros de solicitação, a resposta da API é baseada nos valores de parâmetro fornecidos. Você precisa 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.projection do recurso video especifica o formato de projeção do vídeo. Os valores de propriedade válidos são 360 e rectangular.

• As propriedades recordingDetails.location e fileDetails.recordingLocation do recurso video foram atualizadas para explicar a diferença entre as duas propriedades:

  • A propriedade recordingDetails.location identifica 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 definição da propriedade contentDetails.relatedPlaylists.favorites do recurso channel foi atualizada para informar que o valor da propriedade pode conter um ID de playlist que se refere a uma playlist vazia e não pode ser buscado. Isso ocorre porque a funcionalidade de vídeos favoritos já foi descontinuada. Essa propriedade não está sujeita à política de descontinuação de APIs.

• A definição do erro ineligibleAccount, que pode ser retornado pelos métodos comments.insert, comments.update, commentThreads.insert ou commentThreads.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 part do método channels.update foi atualizada para informar que localizations também é um valor válido para esse parâmetro.

• A seção Uso da cota do guia de primeiros passos foi atualizada para vincular ao Google Developer's Console, onde você pode ver sua cota real e seu uso de cota.

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 channelBanner foi atualizada para informar que o tamanho recomendado para a imagem de banner do canal enviada é de 2560 x 1440 pixels. O tamanho mínimo (2.048 px por 1.152 px) não mudou.

  • A nova propriedade snippet.customUrl do recurso channel identifica 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.watch do recurso channel e todas as propriedades filhas dele foram descontinuados.

  • A resposta da API a uma solicitação search.list agora contém uma propriedade regionCode. A propriedade identifica o código da região usado para a consulta de pesquisa. O código da região instrui a API a retornar resultados de pesquisa para o país especificado.

    O valor da propriedade é um código ISO do país de duas letras que identifica a região. O método i18nRegions.list retorna uma lista de regiões com suporte. O valor padrão é US. Se uma região não suportada 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.label e snippet.secondaryReasons[].label do recurso videoAbuseReportReason foram atualizadas para informar que elas contêm textos de rótulos localizados para os motivos da denúncia de abuso.

    Além disso, o método videoAbuseReportReasons.list agora oferece suporte ao parâmetro hl, que especifica a linguagem que precisa ser usada para o texto do rótulo na resposta da API. O valor do parâmetro padrão é en_US.

  • A nova propriedade contentDetails.contentRating.ecbmctRating do recurso video identifica a classificação de um vídeo do 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 suportam os seguintes novos valores de propriedade:

    • contentDetails.contentRating.fpbRating (África do Sul)
      Classificação: 10; Valor da propriedade: fpb10
    • contentDetails.contentRating.moctwRating (Taiwan)
      Classificação: R-12; Valor da propriedade: moctwR12
    • contentDetails.contentRating.moctwRating (Taiwan)
      Classificação: R-15; Valor da propriedade: moctwR15

  • A propriedade liveStreamingDetails.activeLiveChatId do recurso video conté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 termina, a propriedade não é mais retornada para o vídeo.

  • A propriedade status.rejectionReason do recurso video é compatível com o novo valor de propriedade legal.

• A API oferece suporte aos seguintes erros novos:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	notEditable	Os métodos channelSections.insert, channelSections.update e channelSections.delete retornam esse erro para indicar que a seção de canal especificada não pode ser criada, atualizada ou excluída.
  badRequest (400)	styleRequired	Os métodos channelSections.insert e channelSections.update retornam esse erro para indicar que o recurso channelSection enviado na solicitação de API precisa especificar um valor para a propriedade snippet.style.
  badRequest (400)	typeRequired	Os métodos channelSections.insert e channelSections.update retornam esse erro para indicar que o recurso channelSection enviado na solicitação de API precisa especificar um valor para a propriedade snippet.type.
  badRequest (400)	processingFailure	O método commentThreads.list retorna esse erro para indicar que o servidor da API falhou ao processar a solicitação. Embora isso possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso commentThread no corpo da solicitação para garantir que ele é válido.
  forbidden (403)	commentsDisabled	O método commentThreads.list retorna esse erro para indicar que o vídeo identificado pelo parâmetro videoId desativou os comentários.
  badRequest (400)	commentTextTooLong	O método commentThreads.insert retorna esse erro para indicar que o recurso comment que está sendo inserido contém muitos caracteres na propriedade snippet.topLevelComment.snippet.textOriginal.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	O método playlistItems.insert retorna esse erro para indicar que o vídeo que você está tentando adicionar à playlist já se encontra em outra playlist em série. Acesse a Central de Ajuda do YouTube para mais informações sobre playlists em série.
  badRequest (400)	subscriptionForbidden	O método subscriptions.insert retorna esse erro para indicar que você atingiu o número máximo de assinaturas ou que criou muitas assinaturas recentes. No último caso, você pode repetir a solicitação após algumas horas.
  badRequest (400)	invalidCategoryId	O método videos.update retorna esse erro para indicar que a propriedade snippet.categoryId no recurso video enviado especificou um ID de categoria inválido. Use o método videoCategories.list para recuperar as categorias disponíveis.
  badRequest (400)	invalidDescription	O método videos.update retorna esse erro para indicar que a propriedade snippet.description no recurso video enviado especificou um valor inválido.
  badRequest (400)	invalidPublishAt	O método videos.update retorna esse erro para indicar que a propriedade status.publishAt no recurso video enviado especificou um horário de publicação programada inválido.
  badRequest (400)	invalidRecordingDetails	O método videos.update retorna esse erro para indicar que o objeto recordingDetails no recurso video enviado especificou detalhes de registro inválidos.
  badRequest (400)	invalidTags	O método videos.update retorna esse erro para indicar que a propriedade snippet.tags no recurso video enviado especificou um valor inválido.
  badRequest (400)	invalidTitle	O método videos.update retorna esse erro para indicar que a propriedade snippet.title no recurso video enviado especificou um título de vídeo inválido ou vazio.
  badRequest (400)	invalidVideoMetadata	O método videos.update retorna esse erro para indicar que os metadados da solicitação são inválidos. Esse erro ocorrerá se a solicitação atualizar a parte snippet de um recurso video, mas não definir um valor para as propriedades snippet.title e snippet.categoryId.

18 de dezembro de 2015

As leis da União Europeia (UE) exigem que determinadas divulgações sejam fornecidas e o consentimento seja obtido dos usuários finais na UE. Portanto, os usuários finais na União Europeia precisam 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 do YouTube.

19 de novembro de 2015

A API agora oferece suporte à capacidade de definir e recuperar texto localizado para as propriedades snippet.title e snippet.description dos recursos playlist e video, as propriedades snippet.title do recurso channelSection e snippet.description do recurso channel.

• Configurar títulos e descrições localizados

  É possível definir valores localizados para um recurso ao chamar o método insert ou update desse recurso. Para definir valores localizados para um recurso, faça o seguinte:

  • Verifique se um valor está definido para a propriedade snippet.defaultLanguage do recurso. Essa propriedade identifica o idioma das propriedades snippet.title e snippet.description do 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 propriedade snippet.defaultLanguage como en.

    Observação para atualizar recursos channel:para definir a propriedade snippet.defaultLanguage de um recurso channel, você precisa atualizar a propriedade brandingSettings.channel.defaultLanguage.

  • Adicione o objeto localizations ao recurso que você está atualizando. Cada chave de objeto é uma string que identifica um idioma do aplicativo ou o 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 exemplo de snippet 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:quando você atualiza os dados localizados de um recurso, sua solicitação de API precisa incluir todas as versões localizadas dos dados. Por exemplo, se você enviou uma solicitação subsequente para adicionar dados em português ao vídeo no exemplo acima, a solicitação precisaria incluir os dados localizados para alemão, espanhol e português.

• Como recuperar valores localizados

  A API oferece suporte a duas maneiras de recuperar valores localizados para um recurso:

  • Adicione o parâmetro hl à solicitação channels.list, channelSections.list, playlists.list ou videos.list para recuperar dados localizados de um idioma de aplicativo específico compatível com o site do YouTube. Se os detalhes do recurso localizados estiverem disponíveis nesse idioma, o objeto snippet.localized do recurso vai ter os valores localizados. No entanto, se os detalhes localizados não estiverem disponíveis, o objeto snippet.localized vai conter os detalhes do recurso no idioma padrão.

    Por exemplo, suponha que uma solicitação videos.list tenha recuperado dados do vídeo descrito acima com dados localizados em alemão e espanhol. Se o parâmetro hl fosse definido como de, 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 hl fosse definido como fr, o objeto snippet.localized conteria o título e a descrição em inglês, já que o inglês é o idioma padrão do recurso, e os detalhes localizados em francês não estão disponíveis.

    Importante:o parâmetro hl só aceita valores que identificam idiomas do aplicativo com suporte do site do YouTube. Para determinar se um texto localizado está disponível para outros idiomas, recupere a parte localizations do recurso e filtre para determinar se o texto localizado existe.
    
    Por exemplo, você precisaria recuperar a lista completa de localizações para saber se o texto localizado está disponível em inglês do Apalache.
    
    

  • Ao recuperar um recurso, inclua localizations no valor de parâmetro part para recuperar todos os detalhes localizados desse recurso. Se você estiver recuperando dados localizados de um idioma que não é o idioma atual do aplicativo do YouTube, use essa abordagem para recuperar todas as localizações e, em seguida, filtrar para determinar se os dados localizados desejados existem.

• Erros relacionados a valores de texto localizados

  A API também oferece suporte aos seguintes novos erros para valores de texto localizados:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	defaultLanguageNotSetError	Esse erro indica que uma solicitação que tenta inserir ou atualizar o objeto localizations de um recurso está falhando porque a propriedade snippet.defaultLanguage não está definida para ele. Os métodos channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert e videos.update oferecem suporte a esse erro.
  badRequest (400)	localizationValidationError	Esse erro indica que ocorreu uma falha ao validar um dos valores no objeto localizations de um recurso. Por exemplo, esse erro poderá ocorrer se o objeto tiver um código de idioma inválido. Os métodos channels.update, channelSections.insert, channelSections.update, playlists.insert e playlists.update oferecem suporte a 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 order do método search.list foi atualizado para informar que, se você classificar as transmissões ao vivo por viewCount, os resultados da API serão classificados pela número de espectadores simultâneos enquanto as transmissões ainda estão em andamento.

  • O parâmetro relatedToVideoId do método search.list foi atualizado para informar que, se definido, os únicos outros parâmetros compatíveis são part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (que precisa ser definido como video) e fields. Essa atualização não reflete uma mudança no comportamento da API.

  • A definição da propriedade snippet.publishedAt do recurso video foi atualizada para informar 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 é enviado como privado e torna-se público posteriormente, o valor da propriedade especifica 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 mudança no comportamento da API.

  • A definição da propriedade status.publishAt do recurso video foi atualizada para mostrar estas informações:

    • Se você definir o valor dessa propriedade ao chamar o método videos.update, também deverá configurar o valor da propriedade status.privacyStatus como private, mesmo que o vídeo já seja privado.
    • Se a solicitação programar a publicação de um vídeo em algum momento no passado, ele será publicado imediatamente. Dessa forma, o efeito de definir a propriedade status.publishAt como uma data e hora no passado é o mesmo que mudar o privacyStatus do vídeo de private para public.

  • A propriedade contentDetails.contentRating.cncRating do recurso video especifica a classificação do vídeo segundo a Comissão Francesa de classificação cinematográfica. Essa propriedade substitui a propriedade contentDetails.contentRating.fmocRating, que foi descontinuada.

  • A definição do brandingSettings.channel.keywords do recurso channel foi 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.set foi atualizada para refletir com precisão que o corpo da solicitação contém a imagem em miniatura que você está enviando e associando a um vídeo. O corpo da solicitação não contém um recurso thumbnail. Anteriormente, a documentação dizia que você não deveria 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 activity foi atualizada para refletir o fato de que o método activities.list atualmente não inclui recursos relacionados a novos comentários do vídeo. O snippet.type e o contentDetails.comment do recurso também foram atualizados.

• Erros novos e atualizados

  • A API agora oferece suporte aos seguintes erros:

    Detalhes do erro
    activities.insert	Código de resposta HTTP badRequest (400) Motivo invalidMetadata Descrição A propriedade kind não corresponde ao tipo de ID fornecido.
    commentThreads.update comments.insert comments.update	Código de resposta HTTP badRequest (400) Motivo commentTextTooLong Descrição O recurso comment que está sendo inserido ou atualizado contém muitos caracteres na propriedade snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	Código de resposta HTTP forbidden (403) Motivo playlistItemsNotAccessible Descrição A solicitação não está devidamente autorizada para inserir, atualizar ou excluir o item especificado da playlist.
    playlists.delete playlists.insert playlists.update	Código de resposta HTTP badRequest (400) Motivo playlistForbidden Descrição Esta operação é proibida ou a solicitação não está devidamente autorizada.
    search.list	Código de resposta HTTP badRequest (400) Motivo invalidLocation Descrição O valor do parâmetro location e/ou locationRadius foi formatado incorretamente.
    search.list	Código de resposta HTTP badRequest (400) Motivo invalidRelevanceLanguage Descrição O valor do parâmetro relevanceLanguage foi formatado incorretamente.
    subscriptions.insert	Código de resposta HTTP badRequest (400) Motivo subscriptionForbidden Descrição Esse erro ocorre quando uma das seguintes condições é verdadeira: A assinatura que você está tentando criar já existe Você já atingiu o número máximo de inscrições Você está tentando se inscrever em seu próprio canal, o que não é compatível. Você criou muitas assinaturas recentemente e precisa esperar algumas horas antes de tentar a solicitação novamente.
    videos.update	Código de resposta HTTP badRequest (400) Motivo invalidDefaultBroadcastPrivacySetting Descriçã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.favoriteCount do recurso video foi descontinuada.

    De acordo com nossa política de descontinuação, essa propriedade vai continuar sendo incluída nos recursos do video por pelo menos um ano após esse anúncio. No entanto, o valor da propriedade agora está sempre definido como 0.

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 recurso video foi atualizada para fornecer mais informações sobre como o servidor da API calcula o comprimento do valor da propriedade. Essa atualização não reflete uma mudança no comportamento da API.

    Especificamente, a definição explica que, se uma tag contiver um espaço, o servidor da API tratará o valor da tag como se ele estivesse entre aspas, e as aspas contam para o limite de caracteres. Portanto, para fins de limite de caracteres, a tag Foo-Baz contém sete caracteres, mas a tag Foo Baz contém nove caracteres.

  • O método commentThreads.insert não é mais compatível com o parâmetro shareOnGooglePlus, que indicava se um comentário e as respostas a esse comentário também deveriam ser postados no perfil do Google+ do autor. Se uma solicitação envia o parâmetro, o servidor da API ignora o parâmetro, mas lida com a solicitação.

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 order do método commentThreads.list especifica a ordem em que a resposta da API precisa listar as linhas de execução de comentários. As conversas podem ser ordenadas por tempo ou relevância. O comportamento padrão é ordená-los por tempo.

  • A nova propriedade snippet.defaultAudioLanguage do recurso video especifica o idioma falado na faixa de áudio padrão do vídeo.

  • A definição da propriedade contentDetails.licensedContent do recurso video foi atualizada para esclarecer que o conteúdo precisa ter sido enviado originalmente a um canal vinculado a um parceiro de conteúdo do YouTube e depois reivindicado por ele. Isso não representa uma mudança no comportamento real da API.

  • Os métodos captions.delete, captions.download, captions.insert, captions.list e captions.update agora aceitam o parâmetro onBehalfOfContentOwner, 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 escopo https://www.googleapis.com/auth/youtubepartner.

• Erros novos e atualizados

  • A API agora oferece suporte aos seguintes erros:

    Detalhes do erro
    videos.rate	Código de resposta HTTP badRequest (400) Motivo emailNotVerified Descrição O usuário precisa confirmar o endereço de e-mail antes de avaliar o vídeo.
    videos.rate	Código de resposta HTTP badRequest (400) Motivo videoPurchaseRequired Descrição Vídeos alugados só podem ser avaliados por usuários que os alugaram.

  • Os métodos subscriptions.delete e subscriptions.insert não são mais compatíveis com os erros accountClosed e accountSuspended.

27 de abril de 2015

Esta atualização contém as seguintes alterações:

• Novos recursos e métodos

  • O novo recurso videoAbuseReportReason contém informações sobre o motivo de um vídeo ser sinalizado por incluir conteúdo abusivo. O método videoAbuseReportReasons.list permite que você recupere uma lista de todos os motivos pelos quais os vídeos podem ser sinalizados.

  • O novo método videos.reportAbuse é uma forma de sinalizar vídeos que apresentam conteúdo abusivo. O corpo da solicitação contém um objeto JSON que especifica o vídeo sinalizado e o motivo pelo qual é considerado que ele inclui conteúdo abusivo. Motivos válidos podem ser encontrados no método videoAbuseReportReason.list descrito acima.

    O guia de migração também foi atualizado com um exemplo para denunciar um vídeo abusivo. Com essa alteração, a API v3 agora oferece suporte a todos os recursos da API da v2 para os quais está programado. 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 forDeveloper do método search.list restringe uma pesquisa para recuperar apenas os vídeos enviados por meio do aplicativo ou site do desenvolvedor. O parâmetro forDeveloper pode ser usado com parâmetros de pesquisa opcionais, como q.

    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 forDeveloper como true, o servidor da API usa as credenciais de autorização da solicitação para identificar o desenvolvedor. Por isso, um desenvolvedor pode restringir os resultados a vídeos enviados pelo próprio app ou site, mas não a vídeos enviados por outros apps ou sites.

    O novo recurso oferece funcionalidade semelhante, embora não idêntica, à funcionalidade das tags do desenvolvedor compatível com a API v2.

  • A nova propriedade snippet.country do recurso channel permite que os proprietários de canais associem os canais a um país específico.

    Observação:para definir a propriedade snippet.country de um recurso channel, é necessário atualizar a propriedade brandingSettings.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 correspondem a critérios específicos.

    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 de canal seja 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 do canal correspondente.

    • targeting.regions[]: uma lista de regiões de conteúdo preferenciais do YouTube. A seção do canal fica visível para os usuários que selecionaram uma dessas regiões, bem como para os usuários para os quais uma dessas regiões é selecionada automaticamente.

    • targeting.countries[]: uma lista de países onde 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.duration do recurso video foi corrigida para refletir que o valor pode refletir horas, dias e assim por diante.

  • A documentação dos métodos channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete e videos.delete foi corrigida para refletir que, quando bem-sucedidos, todos esses métodos retornam um código de resposta HTTP 204 (No Content).

• Erros novos e atualizados

  • A API agora oferece suporte aos seguintes erros:

    Tipo de erro	Detalhe do erro	Descrição
    badRequest (400)	targetInvalidCountry	Os métodos channelSections.insert e channelSections.update retornarão esse erro se o recurso channelSection inserido contiver um valor inválido para a propriedade targeting.countries[].
    badRequest (400)	targetInvalidLanguage	Os métodos channelSections.insert e channelSections.update retornarão esse erro se o recurso channelSection inserido contiver um valor inválido para a propriedade targeting.languages[].
    badRequest (400)	targetInvalidRegion	Os métodos channelSections.insert e channelSections.update retornarão esse erro se o recurso channelSection inserido contiver um valor inválido para a propriedade targeting.regions[].
    badRequest (400)	operationNotSupported	O método comments.insert retornará esse erro se o usuário da API não conseguir inserir um comentário em resposta ao comentário de nível superior identificado pela propriedade snippet.parentId. Em um recurso commentThread, a propriedade snippet.canReply indica se o visualizador atual pode responder à linha de execução.
    badRequest (400)	invalidChannelId	O método search.list retornará esse erro se o parâmetro channelId na solicitação especificar um ID de canal inválido.
    badRequest (400)	subscriptionForbidden	O método subscriptions.insert retornará esse erro se o usuário da API tentar se inscrever no próprio canal.

  • O método captions.update não oferece mais suporte aos erros invalidMetadata e videoNotFound.

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. São eles:

  • Recuperar comentários sobre um canal
  • Recuperar todas as conversas de comentários relacionadas a um canal, o que significa que a resposta da API pode conter comentários sobre o canal ou os vídeos dele.
  • Atualizar o texto de um comentário
  • Como marcar um comentário como spam
  • Definir o status de moderação de um comentário

• O guia Como se inscrever em 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 também 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 commentThread e comment da API permitem recuperar, inserir, atualizar, excluir e moderar comentários.

  • Um recurso commentThread contém informações sobre uma sequência de comentários do YouTube, que compreende um comentário de nível superior e respostas, se houver, a esse comentário. O recurso commentThread pode 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 comment aninhados no recurso commentThread. É importante observar que o recurso commentThread não contém necessariamente todas as respostas a um comentário, e você precisará usar o método comments.list se 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 – Recuperar uma lista de sequências de comentários. Use este 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étodo comments.insert para responder a um comentário.
    • commentThreads.update – Modifica um comentário de nível superior.

  • Um recurso comment contém informações sobre um único comentário do YouTube. Um recurso comment pode representar um comentário sobre um vídeo ou um canal. Além disso, o comentário pode ser um comentário 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 para um comentário existente.
    • comments.update – Modifica 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, limpar um comentário para exibição pública ou rejeitar um comentário como impróprio 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-ssl da API, descrito no histórico de revisões de 2 de abril de 2015, é obrigatório para chamadas aos métodos comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert e commentThreads.update.

• O novo guia Como se inscrever em notificações push explica o novo suporte da API para notificações push via PubSubHubBub, um protocolo de publicação/assinatura de servidor para servidor para recursos acessíveis pela Web. Seu servidor de retorno de chamada 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 sem suporte na API v3, a menção do suporte ao PubSubHubBub ainda está listada na seção Descontinuado desse guia.

• O novo escopo https://www.googleapis.com/auth/youtube.force-ssl da API agora é válido para qualquer método de API que oferecia suporte ao escopo https://www.googleapis.com/auth/youtube.

• A API agora oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	invalidRating	O método videos.rate retornará esse erro se a solicitação contiver um valor inesperado para o parâmetro rating.

• O método subscriptions.insert não oferece mais suporte ao erro subscriptionLimitExceeded, que indicava anteriormente que o assinante identificado com a solicitação excedeu o limite de taxa de assinatura.

2 de abril de 2015

Esta atualização contém as seguintes alterações:

• O novo recurso captions representa uma faixa de legenda do YouTube. Uma faixa de legenda está associada a exatamente um vídeo do YouTube.

  A API oferece suporte a 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-ssl da 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 da API do YouTube só está disponível por meio de um endpoint HTTPS. Como resultado, mesmo que o escopo https://www.googleapis.com/auth/youtube não exija uma conexão SSL, na verdade não há outra maneira de fazer uma solicitação de API.

  O novo escopo é necessário para chamadas a 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 Novo na API v3, que lista os recursos compatíveis com a API v3 e não compatíveis com a API v2. Os mesmos recursos foram listados anteriormente e ainda estão listados em outras guias do guia. Por exemplo, o novo recurso que explica como atualizar os dados da campanha promocional em vídeo 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:

  • Como sinalizar um vídeo

• 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.list e definindo o valor do parâmetro home como true.

    Na resposta da API, um recurso corresponderá a um vídeo recomendado se o valor da propriedade snippet.type for recommendation. Nesse caso, as propriedades contentDetails.recommendation.reason e contentDetails.recommendation.seedResourceId conterão informações sobre o motivo da recomendação do vídeo. Não há garantia de que a resposta conterá um número específico de vídeos recomendados.

  • Recuperar sugestões de canal

  • Recuperar novos vídeos de inscrição – A API v3 não recupera uma lista que contém somente vídeos que foram enviados recentemente aos canais nos quais o usuário da API se inscreve. No entanto, é possível usar a API v3 para encontrar novos vídeos de assinatura chamando o método activities.list e definindo o valor do parâmetro home como true.

    Na resposta da API, um recurso corresponderá a um novo vídeo de assinatura se o valor da propriedade snippet.type for upload. Não há garantia de que a resposta conterá um número específico de novos vídeos de inscrição.

  • Compatibilidade com feed RSS

  • Notificações push para atualizações de feed: a API v2 oferecia notificações push, usando o protocolo de atualização simples (Pad) ou o PubSubHubbub (em inglês) para monitorar os feeds de atividade dos usuários do YouTube. Notificações eram fornecidas para novas inscrições em canais e quando os vídeos eram avaliados, compartilhados, marcados como favoritos, comentados ou enviados.

    A API v3 oferece suporte a notificações push usando o protocolo PubSubHubbub, mas as notificações abrangem somente uploads de vídeos e atualizações de títulos ou descrições de vídeos.

  • Localização do canal – A API v2 usava a tag <yt:location> para identificar o local do usuário, conforme inserido no perfil público do canal no YouTube. 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 maneira consistente para essa finalidade.

  • Definir ou recuperar tags de desenvolvedor – A API v2 era compatível com o recurso de associação de palavras-chave, ou tags de desenvolvedor, a um vídeo no momento em que o vídeo foi enviado. As tags de desenvolvedor não são exibidas para os usuários do YouTube, mas os proprietários de vídeos podem recuperar os vídeos que correspondem a uma tag de desenvolvedor específica.

    A API v3 fornecerá um recurso semelhante, mas não idêntico. Especificamente, um desenvolvedor poderá pesquisar por vídeos enviados pelo próprio aplicativo do desenvolvedor. 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 do projeto para pesquisar os vídeos.

  • Listar vídeos por data de publicação, contagem de visualizações ou classificação: na API v2, o parâmetro orderby permite classificar 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 lista de reprodução normalmente 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 envio, vídeo favorito, vídeo com "Gostei" ou vídeo assistido recentemente é adicionado automaticamente como o primeiro item (snippet.position=0) para os seguintes tipos de playlists. Assim, cada uma dessas listas é classificada na ordem do item mais recente para o mais antigo, com base nos horários em que os itens foram adicionados à lista.

    • envios 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" playlist é adicionada como o último item da lista, para que a lista seja efetivamente classificada do item mais antigo para o mais recente.

  • Processamento em lote: a API v3 oferece suporte a um dos casos de uso de processamento em lote permitidos pela API v2. Os métodos channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list e videos.list da API v3 oferecem suporte a um parâmetro id, 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 alterações, o guia agora identifica todas as funcionalidades suportadas na API antiga (v2) que terão seu uso suspenso na versão atual da API (v3).

4 de março de 2015

Esta atualização contém as seguintes alterações:

• Os métodos channelSections.delete e channelSections.update agora aceitam o parâmetro onBehalfOfContentOwner, que já é aceito por vários outros métodos.

• As seguintes propriedades e as propriedades filhas delas foram descontinuadas:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Observação:nenhuma dessas propriedades estava sujeita à política de descontinuação de APIs.

• A nova propriedade contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons do recurso video identifica os motivos que explicam por que o vídeo recebeu a classificação DJCQT (Brasil).

• A API agora oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  notFound (404)	channelNotFound	O método channels.update retornará esse erro se o parâmetro id da solicitação especificar um canal não encontrado.
  badRequest (400)	manualSortRequiredinvalidValue	Os métodos playlistItems.insert e playlistItems.update retornarão 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 elemento snippet.position do recurso enviado no corpo da solicitação. Se você quiser que o item da playlist fique em uma posição específica na lista, primeiro atualize a configuração de ordem da playlist para Manual. É possível ajustar essa configuração no Gerenciador de vídeos do YouTube.
  forbidden (403)	channelClosed	O método playlists.list retornará esse erro se o parâmetro channelId da solicitação especificar um canal que foi fechado.
  forbidden (403)	channelSuspended	O método playlists.list retornará esse erro se o parâmetro channelId da solicitação especificar um canal que foi suspenso.
  forbidden (403)	playlistForbidden	O método playlists.list retornará esse erro se o parâmetro id da solicitação não oferecer suporte à solicitação ou se ela não estiver devidamente autorizada.
  notFound (404)	channelNotFound	O método playlists.list retornará esse erro se o parâmetro channelId da solicitação especificar um canal não encontrado.
  notFound (404)	playlistNotFound	O método playlists.list retornará esse erro se o parâmetro id da solicitação especificar uma playlist que não foi encontrada.
  notFound (404)	videoNotFound	O método videos.list retornará esse erro se o parâmetro id da solicitação especificar um vídeo não encontrado.
  badRequest (400)	invalidRating	O método videos.rate retornará esse erro se a solicitação tiver um valor inesperado para o parâmetro rating.

2 de março de 2015

Esta atualização contém as seguintes alterações:

• O método search.list agora oferece suporte ao parâmetro relevanceLanguage, 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 anteriormente 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 campos de feeds e metadados especiais fornecidos pela API v2 para descrever filmes, trailers, programas de televisão, temporadas e episódios de televisão.

14 de janeiro de 2015

Esta atualização contém as seguintes alterações:

• O guia de migração da API de dados do YouTube (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 à funcionalidade de upload com base no navegador compatível com a API v2. Essa alteração no guia de migração não reflete uma alteração real da API, mas sim a disponibilidade de um novo exemplo de código para fazer upload de vídeos com JavaScript do lado do cliente.

  Dado o suporte para envio de vídeos com a biblioteca cliente JavaScript e o CORS, o guia de migração não lista mais o envio pelo navegador como um recurso que pode ter sido descontinuado na API v3.

• A documentação do método videos.insert foi 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 de uma chamada para o método search.list mudou 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 ao canal GoogleDevelopers.

  • Custo de cota: 100 unidades

    Chame o método search.list e procure GoogleDevelopers.

  • Custo de cota: 6 unidades

    Chame o método channels.list para encontrar o ID correto do canal. Defina o parâmetro forUsername como GoogleDevelopers e o parâmetro part como contentDetails. Na resposta da API, a propriedade contentDetails.relatedPlaylists.uploads especifica o ID da playlist dos vídeos enviados do canal.

    Em seguida, chame o método playlistItems.list e defina o parâmetro playlistId como o ID capturado e o parâmetro part como snippet.

8 de outubro de 2014

Esta atualização contém as seguintes alterações:

• O recurso channel contém duas novas propriedades:

  • A propriedade status.longUploadsStatus indica 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 está qualificado para enviar vídeos com mais de 15 minutos de duração, mas deve ativar o recurso primeiro.
    • disallowed – O canal não está qualificado ou não pode 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.useSmartTiming indica se a campanha promocional do canal usa "tempo inteligente". Esse recurso tenta mostrar promoções em um ponto do vídeo em que elas têm mais chances de receber cliques e têm menos chances de atrapalhar a experiência de visualização. Esse recurso também seleciona uma única promoção para exibir em cada vídeo.

• As definições das propriedades snippet.title e snippet.categoryId do recurso video foram atualizadas para esclarecer como a API processa chamadas para o método videos.update. Se você chamar esse método para atualizar a parte snippet de um recurso video, precisará definir um valor para ambas as propriedades.

  Se você tentar atualizar a parte snippet de um recurso video e não definir um valor para as duas propriedades, a API vai retornar um erro invalidRequest. A descrição desse erro também foi atualizada.

• A propriedade contentDetails.contentRating.oflcRating do recurso video, que identifica a classificação de um vídeo da Agência de Classificação de Filmes e Literatura da Nova Zelândia, agora é compatível com duas novas classificações: oflcRp13 e oflcRp16. Elas correspondem às classificações RP13 e RP16, respectivamente.

• O método channelBanners.insert agora é compatível com o seguinte erro:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	bannerAlbumFull	O álbum de arte do canal do YouTube do proprietário do canal tem muitas imagens. O proprietário do canal deve acessar http://photos.google.com, navegar até a página dos álbuns e remover algumas imagens desse álbum.

12 de setembro de 2014

Esta atualização contém as seguintes alterações:

• O custo de cota de uma chamada para o método search.list mudou de uma para duas unidades, além do custo das partes dos recursos especificadas.

13 de agosto de 2014

Esta atualização contém as seguintes alterações:

• O método subscriptions.insert agora é compatível com o seguinte erro:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	subscriptionLimitExceeded	O assinante identificado com a solicitação excedeu o limite da taxa de assinatura. Você pode tentar mais inscrições em algumas horas.

12 de agosto de 2014

Esta atualização contém as seguintes alterações:

• Um novo guia, intitulado Como migrar seu aplicativo para a API YouTube Data (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 guia pretende 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.insert agora é compatível com o seguinte erro:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	maxPlaylistExceeded	Esse erro ocorrerá se uma playlist não puder ser criada porque o canal já tem o número máximo permitido de playlists.

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 incorrido por chamadas a esse método. Da mesma forma, as definições dos parâmetros part foram 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étodo subscriptions.insert tem um custo de cota de aproximadamente 50 unidades. O recurso subscription também contém três partes (snippet, contentDetails e subscriberSnippet), 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 video agora é compatível com 43 novos sistemas de classificação de conteúdo, que identificam as avaliações que os vídeos receberam de várias agências nacionais.

28 de maio de 2014

Esta atualização contém as seguintes alterações:

• O método search.list agora oferece suporte aos parâmetros location e locationRadius, que permitem pesquisar vídeos associados a uma localização geográfica. Uma solicitação deve especificar um valor para ambos os parâmetros para recuperar resultados com base no local, e a API retornará um erro se uma solicitação incluir somente um dos dois parâmetros.

  • O parâmetro location especifica as coordenadas de latitude/longitude no centro da área geográfica circular.

  • O parâmetro locationRadius especifica 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.

13 de maio de 2014

Esta atualização contém as seguintes alterações:

• A propriedade invideoPromotion.items[] do recurso channel foi atualizada para mostrar que normalmente é possível definir apenas um item promovido para seu canal. Se você tentar inserir muitos itens promovidos, a API retornará um erro tooManyPromotedItems, que tem um código de status HTTP 400.

• O recurso channelSection agora pode conter informações sobre alguns novos tipos de conteúdo em destaque. A propriedade snippet.type do recurso channelSection agora 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.ifcoRating do recurso video identifica a classificação que um vídeo recebeu do Irlandês Film Classification Office.

• A definição da propriedade position.cornerPosition do recurso watermark foi atualizada para mostrar que a marca-d'água sempre aparece no canto superior direito do player.

• A definição do parâmetro q para o método search.list foi atualizada para informar 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.totalResults retornada em uma resposta da API para uma chamada search.list foi atualizada para informar que o valor é uma aproximação e pode não representar um valor exato. Além disso, o valor máximo é 1.000.000. Você não deve usar esse valor para criar links de paginação. Em vez disso, use os valores de propriedade nextPageToken e prevPageToken para determinar se os links de paginação serão exibidos.

• Os métodos watermarks.set e watermarks.unset foram atualizados para refletir que a API retorna um código de resposta HTTP 204 para 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 i18nLanguage identifica um idioma do aplicativo que o site do YouTube oferece suporte. O idioma do aplicativo também pode ser chamado de idioma da interface. Para o site do YouTube, um idioma de aplicativo pode ser selecionado automaticamente com base nas configurações da Conta do Google, no idioma do navegador ou no local do IP, e o usuário também pode selecionar manualmente o idioma desejado para a interface no rodapé do site do YouTube.

  A API suporta um método para listar os idiomas de aplicativo compatíveis. Os idiomas compatíveis podem ser usados como o valor do parâmetro hl ao chamar métodos de API como videoCategories.list e guideCategories.list.

• O novo recurso i18nRegion identifica uma área geográfica que um usuário do YouTube pode selecionar como região de conteúdo preferencial. A região do conteúdo também pode ser chamada de localidade do conteúdo. Para o site do YouTube, uma região de conteúdo pode ser selecionada automaticamente com base em dados heurísticos, como o domínio do YouTube ou o local do IP do usuário, e um usuário também pode selecionar manualmente a região de conteúdo desejada no rodapé do site do YouTube.

  A API oferece suporte a um método para listar as regiões de conteúdo compatíveis. Os códigos de região compatíveis podem ser usados como o valor do parâmetro regionCode ao chamar métodos da API como search.list, videos.list, activities.list e videoCategories.list.

7 de abril de 2014

Esta atualização contém as seguintes alterações:

• O novo recurso channelSection contém informações sobre um conjunto de vídeos que um canal escolheu destacar. Por exemplo, uma seção pode apresentar os envios mais recentes de um canal, 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 canais. Você pode recuperar uma lista de seções de canais para o canal do usuário autenticado. Para isso, basta especificar um determinado ID de canal 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 suporta especificamente para esses novos métodos.

• A definição do objeto fileDetails do recurso video foi atualizada para explicar que esse objeto só vai ser retornado se a propriedade processingDetails.fileDetailsAvailability do vídeo tiver um valor available.

  Da mesma forma, a definição do objeto suggestions do recurso video foi atualizada para explicar que esse objeto só vai ser retornado se a propriedade processingDetails.tagSuggestionsAvailability do vídeo ou a propriedade processingDetails.editorSuggestionsAvailability tiver um valor available.

• A documentação dos métodos videos.insert e videos.update foi atualizada para refletir que a propriedade status.publishAt pode ser definida ao chamar esses métodos.

• A definição do objeto invideoPromotion do recurso channel foi atualizada para explicar que o objeto só pode ser recuperado pelo proprietário do canal.

• A lista de parâmetros do método videos.rate foi atualizada para refletir que ele não oferece suporte ao parâmetro onBehalfOfContentOwner. Esse foi um erro de documentação, porque solicitações videos.rate que definem esse parâmetro retornam um erro 500.

31 de março de 2014

Esta atualização contém as seguintes alterações:

• A nova propriedade status.publishAt do recurso video permite especificar a data e a hora em que um vídeo privado está programado para ser publicado. Esta propriedade só poderá ser definida se o status de privacidade do vídeo for private e se ele 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 oferece suporte à parte contentOwnerDetails para recursos channel. 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. A nova parte não está sujeita à política de descontinuação.

• A documentação agora lista o tamanho máximo de caracteres permitido para as seguintes propriedades:

  Recurso	Propriedade	Comprimento máximo
  channel	invideoPromotion.items[].customMessage	40 caracteres
  video	snippet.title	100 caracteres
  video	snippet.description	5.000 bytes
  video	snippet.tags	500 caracteres. O valor da propriedade é uma lista, e as vírgulas entre os itens da lista são contabilizadas no limite.

• A propriedade brandingSettings.watch.featuredPlaylistId do recurso channel foi descontinuada. A API retornará um erro se você tentar definir seu valor.

• As seguintes propriedades de recurso video foram adicionadas à lista de valores que podem ser definidos ao inserir ou atualizar um vídeo:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• A documentação de erros agora especifica o código de resposta HTTP para cada tipo de erro.

• A API agora oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest (400)	invalidCriteria	O método channels.list retornará esse erro se a solicitação especificar parâmetros de filtro que não podem ser usados em conjunto.
  badRequest (400)	channelTitleUpdateForbidden	O método channels.update retornará esse erro se você tentar atualizar a parte brandingSettings de um canal e mudar o valor da propriedade brandingSettings.channel.title. A API não retornará o erro se você omitir a propriedade.
  badRequest (400)	invalidRecentlyUploadedBy	O método channels.update retornará esse erro se a propriedade invideoPromotion.items[].id.recentlyUploadedBy especificar um ID de canal inválido.
  badRequest (400)	invalidTimingOffset	O método channels.update vai retornar esse erro se a parte invideoPromotion especificar uma diferença de tempo inválida.
  badRequest (400)	tooManyPromotedItems	O método channels.update retornará esse erro se a parte invideoPromotion especificar um número de itens promovidos acima do permitido.
  forbidden (403)	promotedVideoNotAllowed	O método channels.update retornará esse erro se a propriedade invideoPromotion.items[].id.videoId especificar um ID de vídeo que não pode ser encontrado ou não pode ser usado como um item promovido.
  forbidden (403)	websiteLinkNotAllowed	O método channels.update vai retornar esse erro se a propriedade invideoPromotion.items[].id.websiteUrl especificar um URL não permitido.
  required (400)	requiredTimingType	O método channels.update retornará 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)	requiredTiming	O método channels.update precisa especificar um objeto invideoPromotion.items[].timing para cada item promovido.
  required (400)	requiredWebsiteUrl	O método channels.update precisa especificar uma propriedade invideoPromotion.items[].id.websiteUrl para cada item promovido.
  badRequest (400)	invalidPublishAt	O método videos.insert 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.

5 de dezembro de 2013

Esta atualização contém as seguintes alterações:

• A documentação do método search.list foi atualizada para indicar corretamente que você não precisa especificar um valor para exatamente um parâmetro de filtro ao enviar uma solicitação de pesquisa. Em vez disso, você pode definir um valor para um parâmetro de filtro ou para zero.

• As definições dos parâmetros do método search.list foram atualizadas para indicar que você precisa definir o valor do parâmetro type como video se também especificar um valor para qualquer um dos seguintes parâmetros:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• O tamanho mínimo das imagens de banner dos canais enviadas foi reduzido para 2.048 por 1.152 pixels. Anteriormente, o tamanho mínimo era de 2.120 px por 1.192 px. Além disso, a documentação do recurso channel especifica os tamanhos máximos de todas as imagens de banner exibidas pela API. Por exemplo, o tamanho máximo da imagem brandingSettings.image.bannerTvImageUrl para aplicativos de televisão é de 2.120 x 1.192 pixels, mas a imagem real pode ter 2.048 x 1.152 pixels. A Central de Ajuda do YouTube fornece orientações adicionais sobre como otimizar a arte do canal para exibição em diferentes tipos de dispositivos.

• Várias definições de propriedade de recurso channel foram atualizadas para refletir as seguintes informações:

  • O valor da propriedade brandingSettings.channel.description tem um tamanho máximo de 1.000 caracteres.
  • A propriedade brandingSettings.channel.featuredChannelsTitle tem um tamanho máximo de 30 caracteres.
  • A propriedade brandingSettings.channel.featuredChannelsUrls[] agora pode listar até 100 canais.
  • O valor de propriedade brandingSettings.channel.unsubscribedTrailer, se definido, precisa especificar o ID do vídeo do YouTube de um vídeo público ou não listado que pertence ao proprietário do canal.

• O método channels.update agora oferece suporte a atualizações da propriedade invideoPromotion.items[].promotedByContentOwner. Essa propriedade indica se o nome do proprietário do conteúdo será mostrado ao exibir a promoção. Só poderá ser definido se a solicitação de API que define o valor da propriedade for feita em nome do proprietário do conteúdo usando o parâmetro onBehalfOfContentOwner.

• Os métodos playlistItems.list e playlistItems.insert agora aceitam o parâmetro onBehalfOfContentOwner, que já é aceito por vários outros métodos.

• A propriedade contentDetails.contentRating.acbRating agora pode especificar uma classificação do Australian Classification Board (ACB) para filmes ou da Australian Communications and Media Authority (ACMA) para a programação de televisão infantil.

• As novas propriedades contentDetails.contentRating.catvRating e contentDetails.contentRating.catvfrRating identificam 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, que é usado no Quebec, respectivamente.

• A nova propriedade snippet.assignable do recurso videoCategory indica se vídeos atualizados ou vídeos recém-enviados podem ser associados a essa categoria de vídeo.

• Exemplos de código foram adicionados para os seguintes métodos:

  • activities.insert (Ir)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Ir)
  • search.list (Ir)
  • thumbnails.set (Java)
  • videos.insert (Ir)

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 apresentar conteúdo de transmissão ao vivo:

  A nova propriedade snippet.liveBroadcastContent nos 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ão upcoming, active e none.

  • A nova propriedade snippet.liveBroadcastContent do recurso video indica se o vídeo é uma transmissão ao vivo ativa ou futura. A lista abaixo explica os possíveis valores 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 contínua.
    • none – O vídeo não é uma transmissão ao vivo ativa ou futura. Este será o valor da propriedade para transmissões concluídas que ainda estão visíveis no YouTube.

  • A nova propriedade liveStreamingDetails do recurso video é um objeto que contém metadados sobre uma transmissão de vídeo ao vivo. Para recuperar esses metadados, inclua liveStreamingDetails na lista de partes de recursos do valor do parâmetro part. Os metadados incluem as seguintes novas propriedades:

    • liveStreamingDetails.actualStartTime: o horário em que a transmissão começou. Esse valor estará presente quando o estado da transmissão for active.
    • liveStreamingDetails.actualEndTime: o horário em que a transmissão terminou. Esse valor estará presente quando a transmissão for encerrada.
    • 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 liveStreamingDetails no valor do parâmetro part ao chamar os métodos videos.list, videos.insert ou videos.update.

  Observe que dois outros recursos para identificar conteúdo de transmissão ao vivo foram lançados em 1o de outubro de 2013: o parâmetro eventType do método search.list e a propriedade snippet.liveBroadcastContent do resultado da pesquisa.

• O método videos.insert agora oferece suporte ao parâmetro notifySubscribers, que indica se o YouTube precisa enviar uma notificação sobre o novo vídeo aos usuários que se inscreverem no canal do vídeo. O valor padrão do parâmetro é True, que indica que os inscritos serão notificados sobre vídeos recém-enviados. No entanto, o proprietário de um canal que envia muitos vídeos pode preferir definir o valor como False para evitar o envio de uma notificação sobre cada novo vídeo aos inscritos do canal.

• A lista de propriedades que podem ser modificadas ao chamar o método channels.update foi atualizada para incluir as propriedades invideoPromotion.items[].customMessage e invideoPromotion.items[].websiteUrl. Além disso, a lista foi modificada para identificar as propriedades brandingSettings que podem ser modificadas. Essas propriedades brandingSettings já podiam ser modificadas, então a mudança na documentação não reflete uma mudança na funcionalidade existente da API.

• Os métodos playlists.insert, playlists.update e playlists.delete agora oferecem suporte ao parâmetro onBehalfOfContentOwner, que já é aceito com vários outros métodos.

• O método playlists.insert agora oferece suporte ao parâmetro onBehalfOfContentOwnerChannel, que já é aceito por vários outros métodos.

• A propriedade contentDetails.contentRating.tvpgRating do recurso video agora aceita um valor de pg14, que corresponde a uma classificação TV-14.

• A definição da propriedade snippet.liveBroadcastContent, que faz parte dos resultados da pesquisa, foi corrigida para refletir que live é um valor de propriedade válido, mas active não é.

• A propriedade contentDetails.contentRating.mibacRating do recurso video agora é compatível com duas outras classificações:

  • mibacVap (VAP): as crianças precisam estar acompanhadas por um adulto.
  • mibacVm6 (V.M.6): restrito ao público a partir de 6 anos.
  • mibacVm12 (V.M.12): restrito a maiores de 12 anos.

• A nova propriedade invideoPromotion.items[].promotedByContentOwner do recurso channel indica se o nome do proprietário do conteúdo será mostrado ao mostrar a promoção. Esse campo só pode ser definido se a solicitação de API que define o valor for feita em nome do proprietário do conteúdo. Consulte o parâmetro onBehalfOfContentOwner para mais informações.

1o de outubro de 2013

Esta atualização contém as seguintes alterações:

• O novo objeto auditDetails do recurso channel contém dados de canais que uma rede multicanal (RM) avaliaria 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 com o escopo https://www.googleapis.com/auth/youtubepartner-channel-audit. Além disso, qualquer token que use esse escopo precisará ser revogado quando a RM decidir aceitar ou rejeitar o canal ou em até duas semanas após a data de emissão.

• A propriedade invideoPromotion.items[].id.type do recurso channel agora é compatível com o valor recentUpload, 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 no vídeo estão definidos. No entanto, você pode promover o vídeo enviado mais recentemente de outro canal definindo o valor da nova propriedade invideoPromotion.items[].id.recentlyUploadedBy como o ID desse canal.

• O recurso channel contém três novas propriedades, brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl e brandingSettings.image.bannerTvHighImageUrl, que especificam os URLs das imagens de banner que são exibidas nas páginas dos canais em aplicativos de televisão.

• A nova propriedade snippet.liveBroadcastContent nos 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ão upcoming, active e none.

  • Para um recurso video, o valor upcoming indica que o vídeo é uma transmissão ao vivo que ainda não começou, enquanto o valor active indica que o vídeo é uma transmissão ao vivo em andamento.
  • Para um recurso channel, o valor upcoming indica que o canal tem uma transmissão programada que ainda não foi iniciada, enquanto o valor acive indica que o canal tem uma transmissão ao vivo em andamento.

• No recurso watermark, a propriedade targetChannelId mudou 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 de marca d'água está vinculada, a propriedade targetChannelId agora especifica esse próprio valor. Portanto, a propriedade targetChannelId.value do recurso foi removida.

• O método thumbnails.set agora oferece suporte ao parâmetro onBehalfOfContentOwner, que já é aceito por vários outros métodos.

• O método search.list agora oferece suporte ao parâmetro eventType, que restringe uma pesquisa para retornar apenas eventos de transmissão ativos, futuros ou concluídos.

• A nova propriedade contentDetails.contentRating.mibacRating identifica 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 oferece suporte aos seguintes erros:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	invalidImage	O método thumbnails.set retornará esse erro se o conteúdo da imagem fornecida for inválido.
  forbidden	videoRatingDisabled	O método videos.rate retornará 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 watermark identifica uma imagem que é exibida durante as reproduções de vídeos de um canal especificado. 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.set envia e define a imagem de marca d'água de um canal. O método watermarks.unset exclui a imagem de marca d'água de um canal.

  A documentação de erro descreve as mensagens de erro compatíveis com a API especificamente para os métodos watermarks.set e watermarks.unset.

• A nova propriedade statistics.hiddenSubscriberCount do recurso channel contém um valor booleano que indica se o número de inscritos do canal está oculto. Dessa forma, o valor da propriedade será false se a contagem de inscritos do canal for visível publicamente.

• O método playlists.list agora oferece suporte aos parâmetros onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Os dois parâmetros já são aceitos por vários outros métodos.

• O método videos.list agora oferece suporte ao parâmetro regionCode, que identifica a região de conteúdo para a qual um gráfico precisa ser recuperado. Esse parâmetro só pode ser usado com o parâmetro chart. O valor do parâmetro é um código de país ISO 3166-1 Alfa 2.

• O error documentation descreve o novo erro de solicitação comum a seguir, que pode ocorrer em vários métodos de API:

  Tipo de erro	Detalhe do erro	Descrição
  forbidden	insufficientPermissions	Os escopos associados ao token OAuth 2.0 fornecido para a solicitação não são suficientes para acessar os dados solicitados.

15 de agosto de 2013

Esta atualização contém as seguintes alterações:

• O objeto invideoPromotion do recurso channel tem as seguintes propriedades novas e atualizadas:

  • A API agora oferece suporte à capacidade de especificar um site como um item promovido. Para fazer isso, defina o valor da propriedade invideoPromotion.items[].id.type como website e use a nova propriedade invideoPromotion.items[].id.websiteUrl para especificar o URL. Além disso, use a nova propriedade invideoPromotion.items[].customMessage para definir uma mensagem personalizada a ser exibida na promoção.

    Os links podem ser associados a websites, sites comerciais ou sites de redes sociais. Saiba como ativar links no seu conteúdo nas instruções da Central de Ajuda do YouTube sobre sites associados e sites de comerciantes.

    Ao adicionar links promocionais, você concorda que esses links não serão usados para redirecionar tráfego para sites não autorizados e que esses links obedecerão às políticas do Google AdWords, às políticas de anúncios do YouTube, às diretrizes da comunidade e aos Termos de Serviço do YouTube.

  • As propriedades relacionadas às configurações de tempo para exibição de itens promovidos durante a reprodução do vídeo foram reestruturadas:

    • O objeto invideoPromotion.timing foi movido para invideoPromotion.items[].timing. Este objeto agora permite que você personalize os dados de tempo para cada item promovido na lista invideoPromotion.items[].

    • O novo objeto invideoPromotion.defaultTiming especifica as configurações de tempo padrão para sua promoção. Essas configurações definem quando um item promovido será exibido 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 objeto invideoPromotion.items[].timing.

    • A nova propriedade invideoPromotion.items[].timing.durationMs especifica por quanto tempo, em milissegundos, a promoção será exibida. O objeto invideoPromotion.defaultTiming também contém um campo durationMs que especifica o período padrão de exibição do item promovido.

  • As propriedades invideoPromotion.items[].type e invideoPromotion.items[].videoId foram movidas para o objeto invideoPromotion.items[].id.

• O método subscriptions.list agora oferece suporte aos parâmetros onBehalfOfContentOwner e onBehalfOfContentOwnerChannel. Os dois parâmetros já são aceitos por vários outros métodos.

• Na resposta da API a uma solicitação thumbnails.set, o valor da propriedade kind mudou de youtube#thumbnailListResponse para youtube#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.insert também foi removido, já que a funcionalidade demonstrada agora é processada pelo método videos.rate.

• O error documentation descreve o novo erro de contexto de solicitação a seguir, que pode ocorrer em qualquer método de API compatível com o parâmetro de solicitação mine:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	invalidMine	O parâmetro mine não pode ser usado em solicitações em que o usuário autenticado é um parceiro do YouTube. Remova o parâmetro mine, faça a autenticação como um usuário do YouTube removendo o parâmetro onBehalfOfContentOwner ou atue como um dos canais do parceiro fornecendo o parâmetro onBehalfOfContentOwnerChannel, 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 da cota do guia Introdução à API de dados do YouTube foi atualizada para refletir uma alteração no custo de cota de um upload de vídeo de aproximadamente 16.000 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 propriedade kind mudou de youtube#channelBannerInsertResponse para youtube#channelBannerResource. Esse recurso é retornado em resposta a uma solicitação channelBanners.insert.

• A nova propriedade brandingSettings.channel.profileColor do recurso channel especifica 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 se aplica a todas as atividades de um canal ou apenas a novos envios. A nova propriedade contentDetails.activityType do recurso subscription identifica os tipos de atividades sobre as quais o assinante será notificado. Os valores de propriedade válidos são all e uploads.

• O método videos.list é compatível com novos parâmetros para recuperar um gráfico dos vídeos mais populares no YouTube:

  • O parâmetro chart identifica o gráfico que você quer recuperar. Atualmente, o único valor aceito é mostPopular. O chart é um parâmetro de filtro. Isso significa que ele não pode ser usado na mesma solicitação que outros parâmetros de filtro (id e myRating).
  • O parâmetro videoCategoryId identifica a categoria de vídeo para a qual o gráfico deve ser recuperado. Esse parâmetro só pode ser usado com o parâmetro chart. Por padrão, os gráficos não são restritos a determinada categoria.

• A nova propriedade topicDetails.relevantTopicIds[] do recurso video fornece uma lista de IDs de tópicos do Freebase que são relevantes para o vídeo ou seu conteúdo. Os assuntos desses tópicos podem ser mencionados ou aparecer no vídeo.

• A propriedade recordingDetails.location.elevation do recurso video foi renomeada como recordingDetails.location.altitude, e a propriedade fileDetails.recordingLocation.location.elevation, como fileDetails.recordingLocation.location.altitude.

• O objeto contentDetails.contentRating do recurso video especifica as classificações que um vídeo recebeu em vários esquemas, incluindo classificações da MPAA, TVPG e assim por diante. Para cada sistema de classificação, a API agora oferece suporte a um valor que indica que o vídeo não foi avaliado. Para as classificações da MPAA, a expressão "sem classificação" classificação é frequentemente usada para identificar versões sem corte de filmes para os quais a versão cortada do filme recebeu uma classificação oficial.

• A nova propriedade contentDetails.contentRating.ytRating do recurso video identifica conteúdo com restrição de idade. O valor da propriedade será ytAgeRestricted se o YouTube tiver identificado o vídeo como tendo conteúdo impróprio para usuários menores de 18 anos. Se a propriedade estiver ausente ou o valor dela estiver vazio, isso significa que o conteúdo não foi identificado como uma restrição de idade.

• O parâmetro mySubscribers do método channels.list foi descontinuado. Use o método subscriptions.list e o parâmetro mySubscribers para recuperar uma lista de inscritos no canal do usuário autenticado.

• Os métodos channelBanners.insert, channels.update, videos.getRating e videos.rate agora oferecem suporte ao parâmetro onBehalfOfContentOwner. 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.update foi atualizada para refletir o fato de que esse método pode ser usado para atualizar o objeto brandingSettings do recurso channel e as propriedades filhas dele. A documentação agora também lista a lista atualizada de propriedades que podem ser definidas para o objeto invideoPromotion do recurso channel.

• O error documentation descreve os seguintes novos erros:

  Tipo de erro	Detalhe do erro	Descrição
  forbidden	accountDelegationForbidden	Esse erro não é específico a um método de API específico. Ele indica que o usuário autenticado não está autorizado a agir em nome da Conta do Google especificada.
  forbidden	authenticatedUserAccountClosed	Esse erro não é específico a um método de API específico. Indica que a conta do YouTube do usuário autenticado foi encerrada. Se o usuário estiver agindo em nome de outra Conta do Google, esse erro indicaria que essa outra conta foi encerrada.
  forbidden	authenticatedUserAccountSuspended	Esse erro não é específico a um método de API específico. Ele 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 vai indicar que essa outra conta está suspensa.
  forbidden	authenticatedUserNotChannel	Esse erro não é específico a um método de API específico. Ela indica que o servidor da API não consegue identificar o canal associado à solicitação de API. Se a solicitação estiver autorizada e usar o parâmetro onBehalfOfContentOwner, você também precisará definir o parâmetro onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	Esse erro não é específico a 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.
  notFound	contentOwnerAccountNotFound	Esse erro não é específico a um método de API específico. A conta do proprietário de conteúdo especificada não foi encontrada.
  badRequest	invalidPart	Esse erro não é específico a um método de API específico. O parâmetro part da solicitação especifica partes que não podem ser gravadas ao mesmo tempo.
  badRequest	videoChartNotFound	O método videos.list retorna esse erro quando a solicitação especifica um gráfico de vídeo incompatível ou indisponível.
  notFound	videoNotFound	O método videos.update retorna esse erro para indicar que o vídeo que você está tentando atualizar não pode ser encontrado. Verifique o valor da propriedade id no corpo da solicitação para garantir que ele está correto.

10 de junho de 2013

Esta atualização contém as seguintes alterações:

• O novo parâmetro forUsername do método channels.list permite recuperar informações sobre um canal especificando seu nome de usuário do YouTube.

• O método activities.list agora oferece suporte ao parâmetro regionCode, 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 aos usuários autorizados que estiverem recuperando dados sobre as próprias playlists. Usuários autorizados também podem definir tags de playlist ao chamar os métodos playlists.insert ou playlists.update.

• O parâmetro onBehalfOfContentOwner, que antes era compatível com os métodos channels.list e search.list, agora também é compatível com os métodos videos.insert, videos.update e videos.delete. Quando esse parâmetro é usado em uma chamada para o método videos.insert, a solicitação também precisa especificar um valor para o novo parâmetro onBehalfOfContentOwnerChannel, que identifica o canal ao qual o vídeo será adicionado. O canal precisa estar vinculado ao proprietário do conteúdo especificado pelo parâmetro onBehalfOfContentOwner.

  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 do 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 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 de canal, sem precisar fornecer credenciais de autenticação para cada canal.

  Especificamente em relação a este lançamento, o parâmetro agora permite que um parceiro de conteúdo insira, atualize ou exclua vídeos em qualquer um dos canais do YouTube de propriedade do parceiro.

• O error documentation descreve os seguintes novos erros:

  Tipo de erro	Detalhe do erro	Descrição
  forbidden	insufficientCapabilities	Esse erro não é específico a um método de API específico. Isso 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.
  unauthorized	authorizationRequired	O método activities.list retorna esse erro quando a solicitação usa o parâmetro home, mas não está devidamente autorizada.

• No recurso channels, a propriedade invideoPromotion.channelId foi removida porque o ID do canal já foi especificado usando a propriedade id do recurso.

• O novo guia Trabalhar com IDs de canais explica como a API usa IDs de canais. Este guia pode ser especialmente útil para desenvolvedores que migram da versão anterior da API e que têm aplicativos que solicitam conteúdo para o usuário default ou que confiam na noção de que cada canal do YouTube tem um nome de usuário único, 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.insert permite fazer upload de uma imagem de banner que pode ser definida posteriormente como a imagem do banner de um canal usando a nova propriedade brandingSettings.image.bannerExternalUrl do recurso channel.

• A documentação do método channels.update foi atualizada para listar as propriedades que podem ser modificadas ao chamar o método.

• A documentação do recurso video não lista mais unspecified como um valor de propriedade válido para as propriedades suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] e suggestions.editorSuggestions[].

• O parâmetro maxResults do método videos.list agora tem um valor padrão de 5.

• O error documentation agora lista erros para os métodos channelBanners.insert e subscriptions.list. Também lista vários novos erros para o método channels.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 os exemplos de código Python agora inclui exemplos para adicionar uma assinatura, 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 sujeitas à política de suspensão de uso.

8 de maio de 2013

Esta atualização contém as seguintes alterações:

• Os recursos do canal agora oferecem suporte ao objeto inVideoPromotion, que encapsula informações sobre uma campanha promocional associada ao canal. Um canal pode usar uma campanha promocional em vídeo para exibir imagens em miniatura para um vídeo promovido no player de vídeo durante as reproduções dos vídeos do canal.

  É possível recuperar esses dados incluindo invideoPromotion no valor de parâmetro part em uma solicitação channels.list.

• O novo método channels.update pode ser usado para atualizar os dados de uma campanha promocional em vídeo de um canal. O método oferece suporte apenas para atualizações da parte invideoPromotion do recurso channel e ainda não oferece suporte a atualizações para outras partes desse recurso.

2 de maio de 2013

Esta atualização contém as seguintes alterações:

• Os recursos do canal agora oferecem suporte à 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 tenha um desses links já tem uma identidade pública do YouTube, que é um pré-requisito para várias ações, como enviar vídeos.

• Os recursos de assinatura agora oferecem suporte à parte subscriberSnippet. Esse objeto encapsula os dados de snippets do canal do inscrito.

• A API agora oferece suporte ao método videos.getRating, que recupera as avaliações que o usuário autenticado deu a uma lista de um ou mais vídeos.

• O novo parâmetro myRating do método videos.list permite recuperar uma lista de vídeos que o usuário autenticado classificou com like ou dislike.

  Os parâmetros myRating e id agora são considerados parâmetros de filtro. Isso significa que uma solicitação de API precisa especificar exatamente um dos parâmetros. Anteriormente, o parâmetro id era obrigatório para esse método.

  O método retorna um erro forbidden para solicitações que tentam recuperar informações de classificação de vídeo, mas não estão devidamente autorizadas para isso.

• Com o lançamento do parâmetro myRating, o método videos.list também foi atualizado para oferecer suporte à paginação. No entanto, os parâmetros de paginação são compatíveis apenas com solicitações que usam o parâmetro myRating. Parâmetros e informações de paginação não são compatíveis com solicitações que usam o parâmetro id.

  • O parâmetro maxResults especifica o número máximo de vídeos que a API pode retornar no conjunto de resultados, e o parâmetro pageToken identifica uma página específica no conjunto de resultados que você quer recuperar.

  • O recurso youtube#videoListResponse, que é retornado em resposta a uma solicitação videos.list, agora contém o objeto pageInfo, que contém detalhes como o número total de resultados e o número de resultados incluídos no conjunto de resultados atual. O recurso youtube#videoListResponse também pode incluir as propriedades nextPageToken e prevPageToken, cada uma fornecendo um token que pode ser usado para recuperar uma página específica do conjunto de resultados.

• O método videos.insert é compatível com os seguintes novos parâmetros:

  • autoLevels – Defina esse valor de parâmetro como true para instruir o YouTube a ajustar automaticamente a iluminação e a cor do vídeo.
  • stabilize – Defina esse valor de parâmetro como true para instruir o YouTube a ajustar o vídeo, removendo a instabilidade resultante dos movimentos da câmera.

• A propriedade channelTitle foi adicionada a snippet para 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 em que ele está 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 mySubscribers do método subscriptions.list permite que você recupere uma lista dos assinantes do usuário autenticado no momento. Esse parâmetro só pode ser usado em uma solicitação devidamente autorizada.

  Observação:essa funcionalidade substitui o parâmetro mySubscribers atualmente compatível com o método channels.list. Esse parâmetro será descontinuado.

• Em um recurso video, o valor da propriedade unspecified não é mais um valor possível para nenhuma destas propriedades:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• As solicitações de API que contêm um parâmetro inesperado agora retornam um erro badRequest, e o motivo informado é unexpectedParameter.

• O erro que o método playlistItems.insert retorna quando a playlist já contém o número máximo de itens permitidos foi atualizado. O erro agora é relatado como forbidden, e o motivo é playlistContainsMaximumNumberOfVideos.

19 de abril de 2013

Esta atualização contém as seguintes alterações:

• O novo método videos.rate permite que um usuário defina uma classificação like ou dislike em um vídeo ou remova uma classificação dele.

  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 em miniatura agora são identificadas na documentação da API como um recurso separado, e o novo método thumbnails.set permite que você envie uma miniatura personalizada para o YouTube e a configure 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 em miniatura são retornadas nesses recursos da mesma forma que antes, embora a documentação agora liste os nomes dos diferentes tamanhos de miniaturas que a API pode retornar.

• A nova parte brandingSettings do recurso channel identifica configurações, texto e imagens para a página do canal e para as páginas de exibição de vídeos.

• O recurso playlistItem contém as novas propriedades a seguir:

  • O novo objeto status encapsula informações de status sobre o item da playlist, e a propriedade status.privacyStatus identifica o status de privacidade do item da playlist.

• O recurso video contém as novas propriedades a seguir:

  • A propriedade status.publicStatsViewable indica se as estatísticas de vídeo estendidas na página de exibição estão visíveis publicamente. Por padrão, essas estatísticas são visíveis, e estatísticas como a contagem de visualizações e as classificações de um vídeo ainda estarão visíveis publicamente, mesmo que o valor dessa propriedade seja definido como false. É possível definir o valor dessa propriedade ao chamar o método videos.insert ou videos.update.

  • O objeto contentDetails.contentRating encapsula as classificações recebidas pelo vídeo em vários esquemas de classificação. A lista abaixo identifica os sistemas de classificação suportados 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
    Estados Unidos	Motion Picture Association of America (MPAA)	contentDetails.contentRating.mpaaRating
    Estados Unidos	Orientação dos pais para a televisão	contentDetails.contentRating.tvpgRating
    Austrália	Conselho Australiano de Classificação (ACB, na sigla em inglês)	contentDetails.contentRating.acbRating
    Brasil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canadá	Sistema canadense de classificação de vídeos caseiros (CHVRS, na sigla em inglês)	contentDetails.contentRating.chvrsRating
    França	Centre National du cinéma et de l'image animée (Ministério da Cultura da França)	contentDetails.contentRating.fmocRating
    Alemanha	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Grã-Bretanha	Conselho Britânico de Classificação de Filmes (BBFC, na sigla em inglês)	contentDetails.contentRating.bbfcRating
    Índia	Conselho Central de Certificação de Filmes (CBFC, na sigla em inglês)	contentDetails.contentRating.cbfcRating
    Japão	映倫管理委員区 (EIRIN)	contentDetails.contentRating.eirinRating
    Coreia	多欼ิุลก (KMRB)	contentDetails.contentRating.kmrbRating
    México	Direção Geral de Rádio, Televisão e Cinematografia (RTC)	contentDetails.contentRating.rtcRating
    Nova Zelândia	Escritório de Classificação de Filmes e Literatura	contentDetails.contentRating.oflcRating
    Rússia	Registro Nacional de Filmes da Federação Russa	contentDetails.contentRating.russiaRating
    Espanha	Instituto de Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• A documentação do método playlistItems.update foi atualizada para refletir o fato de que a propriedade snippet.resourceId precisa ser especificada no recurso enviado como o corpo da solicitação.

• O método search.list agora é compatível com esta funcionalidade:

  • O novo parâmetro forMine restringe uma pesquisa para recuperar apenas os vídeos do usuário autenticado.

  • O parâmetro order agora 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 safeSearch indica se os resultados da pesquisa precisam incluir conteúdo restrito.

• O método videos.insert é compatível com vários novos erros, listados na tabela abaixo:

  Tipo de erro	Detalhe do erro	Descrição
  badRequest	invalidCategoryId	A propriedade snippet.categoryId especifica um ID de categoria inválido. Use o método videoCategories.list para recuperar as categorias disponíveis.
  badRequest	invalidRecordingDetails	O metadata specifies invalid recording details.
  badRequest	invalidVideoGameRating	Os metadados da solicitação especificam uma classificação de video game inv.
  badRequest	invalidVideoMetadata	Os metadados da solicitação são inválidos.

• O parâmetro onBehalfOfContentOwner foi removido da lista de parâmetros compatíveis com os métodos videos.update e videos.delete.

12 de março de 2013

Esta atualização contém as seguintes alterações:

• A propriedade channelTitle foi adicionada a snippet para os seguintes recursos:

  • activity: a propriedade especifica o nome do canal responsável pela atividade.
  • search: a propriedade especifica o nome do canal associado ao recurso identificado pelo resultado da pesquisa.
  • video – A propriedade especifica o nome do canal que enviou o vídeo.

• O método search.list é compatível com os seguintes novos parâmetros:

  • O parâmetro channelType permite restringir uma pesquisa de canais para recuperar todos os canais ou apenas programas.

  • O parâmetro videoType permite restringir uma pesquisa de vídeos para recuperar todos os vídeos ou apenas filmes ou apenas episódios de programas.

• A definição da parte recordingDetails do recurso video foi atualizada para informar que o objeto só será retornado para um vídeo se os dados de geolocalização ou o tempo de gravação tiverem sido definidos.

• O método playlistItems.update agora retorna um erro invalidSnippet, que vai ser 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 seu conteúdo no YouTube.

  • O parâmetro onBehalfOfContentOwner 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 do 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 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 de canal, sem precisar fornecer credenciais de autenticação para cada canal.

    Os métodos channels.list, search.list, videos.delete, videos.list e videos.update oferecem suporte a esse parâmetro.

  • O parâmetro managedByMe, que tem suporte do método channels.list, instrui a API a retornar todos os canais de propriedade do proprietário do conteúdo especificados pelo parâmetro onBehalfOfContentOwner.

  • O parâmetro forContentOwner, que tem suporte do método search.list, instrui a API a restringir os resultados da pesquisa para incluir apenas recursos pertencentes ao proprietário do conteúdo especificado pelo parâmetro onBehalfOfContentOwner.

25 de fevereiro de 2013

Esta atualização contém as seguintes alterações:

• A API é compatível com várias partes e propriedades novas para os recursos video:

  • As novas partes fileDetails, processingDetails e suggestions fornecem informações aos proprietários de vídeos sobre os vídeos enviados. Esses dados são muito úteis em aplicativos que permitem o envio de vídeos e incluem:

    • 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 dos metadados ou vídeos
    • detalhes sobre o arquivo original enviado ao YouTube

    Todas essas partes podem ser recuperadas somente pelo proprietário do vídeo. A lista abaixo descreve brevemente as novas partes, e a documentação do recurso video define todas as propriedades que cada parte contém.

    • O objeto fileDetails contém informações sobre o arquivo de vídeo enviado para o YouTube, incluindo a resolução, a duração, os codecs de áudio e vídeo, as taxas de bits do stream e muito mais.

    • O objeto processingProgress conté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. Esta parte também indica se os diferentes tipos de dados ou de conteúdo, como detalhes do arquivo ou imagens em miniatura, estão disponíveis para o vídeo.

      Esse objeto foi projetado para ser pesquisado para que o usuário que fez o envio do vídeo possa acompanhar o progresso que o YouTube fez no processamento do arquivo de vídeo enviado.

    • O objeto suggestions contém sugestões que identificam oportunidades para melhorar a qualidade do vídeo ou os metadados do vídeo enviado.

  • A parte contentDetails conté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 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 status contém duas novas propriedades. Os proprietários de vídeos podem definir valores para ambas as 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 em outro site.
    • license: especifica a licença do vídeo. Os valores válidos são creativeCommon e youtube.

• A definição do parâmetro part foi atualizada para os métodos videos.list, videos.insert e videos.update para listar as partes recém-adicionadas descritas acima, bem como a parte recordingDetails, que foi omitida acidentalmente.

• A nova propriedade contentDetails.googlePlusUserId do recurso channel especifica 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 em miniatura agora especifica a largura e a altura da imagem. No momento, as imagens em miniatura são retornadas nos recursos activity, channel, playlist, playlistItem, search result, subscription e video.

• O playlistItems.list agora oferece suporte ao parâmetro videoId, que pode ser usado com o parâmetro playlistId para recuperar apenas o item da playlist que representa o vídeo especificado.

  A API retornará um erro notFound se o vídeo identificado pelo parâmetro não puder ser 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.channelId do recurso channel foi removida. A propriedade id do recurso fornece o mesmo valor.

30 de janeiro de 2013

Esta atualização contém as seguintes alterações:

• A nova página error lista erros que a API pode retornar. A página inclui erros gerais, que podem ocorrer para vários métodos de API diferentes, bem como erros específicos do método.

16 de janeiro de 2013

Esta atualização contém as seguintes alterações:

• Os exemplos de código já estão disponíveis para os métodos e linguagens mostrados na lista abaixo:

  • activities.insert: Java
  • playlistItems.insert: Python
  • playlistItems.list: Java, JavaScript, PHP, Python, Ruby
  • playlists.insert: Java, JavaScript e Python
  • search.list: Java, JavaScript, Python, Ruby
  • videos.insert: Java

• Um recurso activity agora pode informar uma ação channelItem, que ocorre quando o YouTube adiciona um vídeo a um canal gerado automaticamente. (O YouTube identifica algoritmicamente os tópicos que têm uma presença significativa no site do YouTube e gera canais automaticamente para esses tópicos.)

• Os seguintes parâmetros de search.list foram atualizados:

  • O parâmetro q não está mais designado como um filtro, o que significa...
  • O parâmetro relatedToVideo foi renomeado como relatedToVideoId.
  • O parâmetro published foi substituído por dois novos parâmetros, publishedAfter e publishedBefore, descritos abaixo.

• O método search.list é compatível com os seguintes novos parâmetros:

  Nome do parâmetro	Valor	Descrição
  channelId	string	Retorna recursos criados pelo canal especificado.
  publishedAfter	datetime	Retorna os recursos criados após o tempo especificado.
  publishedBefore	datetime	Retorna recursos criados antes do tempo especificado.
  regionCode	string	Retorna recursos para o país especificado.
  videoCategoryId	string	Filtrar os resultados da pesquisa de vídeos para incluir apenas vídeos associados à categoria de vídeo especificada.
  videoEmbeddable	string	Filtre os resultados da pesquisa de vídeo para incluir apenas vídeos que possam ser reproduzidos em um player incorporado em uma página da Web. Defina o valor do parâmetro como true para recuperar apenas vídeos incorporáveis.
  videoSyndicated	string	Filtrar os resultados da pesquisa de vídeos para incluir apenas os vídeos que podem ser reproduzidos fora do YouTube.com. Defina o valor do parâmetro como true para recuperar somente vídeos distribuídos.

• Vários recursos da API oferecem suporte a novas propriedades. A tabela abaixo identifica os recursos e as novas propriedades:

  Recurso	Nome da propriedade	Valor	Descrição
  activity	contentDetails.playlistItem.playlistItemId	string	O ID do item que o YouTube atribuiu para identificar exclusivamente o item na playlist.
  activity	contentDetails.channelItem	object	Um objeto que contém informações sobre um recurso que foi adicionado a um canal. Esta propriedade só estará presente se snippet.type for channelItem.
  activity	contentDetails.channelItem.resourceId	object	Um objeto que identifica o recurso que foi adicionado ao canal. Como outras propriedades de resourceId, ela contém uma propriedade kind que especifica o tipo de recurso, como vídeo ou playlist. Ele também contém exatamente uma das várias propriedades (videoId, playlistId etc.) que especifica o ID que identifica o recurso de forma exclusiva.
  channel	status	object	Este objeto encapsula informações sobre o status de privacidade do canal.
  channel	status.privacyStatus	string	O status de privacidade do canal. Os valores válidos são: private e public.
  playlist	contentDetails	object	Este objeto contém metadados sobre o conteúdo da playlist.
  playlist	contentDetails.itemCount	unsigned integer	O número de vídeos na playlist.
  playlist	player	object	Esse objeto contém informações que você usaria para reproduzir a playlist em um player incorporado.
  playlist	player.embedHtml	string	Uma tag <iframe> que incorpora um player de vídeo que reproduz a playlist.
  video	recordingDetails	object	Este objeto encapsula informações que identificam ou descrevem o local e a hora em que o vídeo foi gravado.
  video	recordingDetails.location	object	Este objeto contém informações de geolocalização associadas ao vídeo.
  video	recordingDetails.location.latitude	double	Latitude em graus.
  video	recordingDetails.location.longitude	double	Longitude em graus.
  video	recordingDetails.location.elevation	double	Altitude acima da Terra, em metros.
  video	recordingDetails.locationDescription	string	Uma descrição em texto do local onde o vídeo foi gravado.
  video	recordingDetails.recordingDate	datetime	A data e a hora em que o vídeo foi gravado. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

• A documentação de vários métodos de API agora identifica as propriedades que devem 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 pode já listar as propriedades obrigatórias e modificáveis.

  Método	Propriedades
  activities.insert	Propriedades obrigatórias: snippet.description Propriedades modificáveis: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Propriedades obrigatórias: id
  playlistItems.update	Propriedades obrigatórias: id
  videos.update	Propriedades obrigatórias: id

• A API não informará mais um erro playlistAlreadyExists se você tentar criar ou atualizar uma playlist que tenha o mesmo título de uma playlist 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 suportados recentemente:

  Método	Tipo de erro	Detalhe do erro	Descrição
  guideCategories.list	notFound	notFound	A categoria de guia identificada pelo parâmetro id não foi encontrada. Use o método guideCategories.list para recuperar uma lista de valores válidos.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	A solicitação não está devidamente autorizada a excluir o item da playlist especificado.
  videoCategories.list	notFound	videoCategoryNotFound	A categoria de vídeo identificada pelo parâmetro id não pode ser encontrada. Use o método videoCategories.list para recuperar uma lista de valores válidos.