Descontinuação da API YouTube Data v2: perguntas frequentes

Meu aplicativo depende de comentários, legendas ou alguma outra funcionalidade que não está presente na API YouTube Data v3. O que devo fazer?

Por enquanto, você pode continuar usando a API v2 para comentários e envio de legendas de vídeo. Em breve, vamos adicionar essa funcionalidade à API v3. Ainda não temos datas específicas, mas vamos lançar essa funcionalidade para que os desenvolvedores tenham o máximo de tempo possível para migrar para a v3.

Para alguns outros recursos, à medida que o YouTube evolui, não haverá paridade de recursos de 100% entre as APIs v2 e v3. Consulte a documentação da API v3 para mais detalhes sobre as funcionalidades compatíveis com essa versão.

Na v2, consigo autenticar usando um endereço de e-mail e uma senha via ClientLogin. Como posso fazer a transição para o OAuth 2.0?

Consulte nosso guia Migração do ClientLogin para o OAuth 2.0.

Como a cota difere na v2 e na v3? Quais são as semelhanças?

As versões 2 e 3 usam um sistema de cotas baseado em custos em que algumas operações (como uploads) consomem uma quantidade maior de cota do que outras (como pesquisas).

A diferença mais significativa entre os sistemas v2 e v3 é que o v3 oferece um pool de cotas global, o que não acontecia na v2. Na v2, as solicitações feitas com uma única chave de desenvolvedor, mas vindas de endereços IP distintos ou de usuários autenticados diferentes, não podiam causar erros de cota global para essa chave. O pior que poderia acontecer seria um erro de cota localizado associado ao endereço IP ou ao canal do YouTube.

Na v3, há um pool de cota global (de 50 milhões de unidades/dia), e todas as chamadas de API associadas a um projeto específico no Developers Console diminuem a cota desse pool. Portanto, é teoricamente possível que um único endereço IP ou canal consuma toda a cota associada a um registro de API, o que pode levar a uma interrupção que afeta outros usuários.

No entanto, ainda é possível se proteger contra um único usuário que esgota o pool de cota global. Esta documentação pública explica como definir e aplicar limites de taxa mais rígidos por usuário.

A API Data v2 oferecia suporte ao acesso anônimo à API para consultas somente leitura, como pesquisas de vídeo. Por que preciso me registrar para fazer chamadas somente leitura na v3?

A API v3 é criada com base na infraestrutura moderna de APIs do Google, em que o uso de várias APIs diferentes pode ser vinculado a um registro específico do Developer Console. Isso oferece aos desenvolvedores uma visão unificada das tecnologias do Google que eles estão usando.

Para chamadas de API que acessam apenas dados disponíveis publicamente, como consultas de pesquisa, os clientes de API podem especificar uma chave de API simples ao fazer uma solicitação de API. As chamadas de API que acessam dados particulares do usuário precisam especificar tokens do OAuth 2.0.

Os desenvolvedores podem receber chaves de API simples e as credenciais necessárias para gerar tokens OAuth 2.0 no Google Developers Console. Os desenvolvedores também podem testar a API sem criar um projeto primeiro usando o APIs Explorer.

Posso continuar usando as mesmas bibliotecas de cliente que usei com a v2 depois de migrar para a v3?

A API v3 é fundamentalmente diferente da v2, e há um novo conjunto de bibliotecas de cliente para usar. Todas estão disponíveis em https://developers.google.com/youtube/v3/libraries e têm suporte nativo para autorização do OAuth 2.

Eu usava a API YouTube Insight, que faz parte da v2. Qual é a alternativa?

Recomendamos que todos os desenvolvedores migrem da API YouTube Insight, que foi descontinuada separadamente em setembro de 2013, para a nova API YouTube Analytics.

Uso a API GData (v1 ou v2) para feeds RSS/Atom de vídeos do YouTube. Tenho alguma alternativa depois que eles forem descontinuados?

No momento, não há uma alternativa direta. Recomendamos que você ofereça aos usuários do seu aplicativo a capacidade de gerenciar e recuperar as inscrições no YouTube usando os métodos do serviço subscriptions da API YouTube Data v3.

Como ainda estou usando alguns recursos da v2 que ainda não estão disponíveis na v3, preciso acessar as duas versões da API no mesmo aplicativo. Quais são as práticas recomendadas?

Você pode usar o suporte do OAuth 2.0 nas bibliotecas de cliente v3 para receber tokens de autorização que funcionam em operações de gravação nas versões 2 e 3. Qualquer token com escopo https://gdata.youtube.com ou https://www.googleapis.com/auth/youtube funciona para as duas APIs.

Para chamadas de API que não exigem tokens OAuth 2.0, obtenha uma chave de API v3 em https://cloud.google.com/console e use-a nas versões v2 e v3.

Recomendamos migrar seu app para usar a API v3 sempre que possível, mesmo que você ainda precise chamar a API v2 para alguma funcionalidade. Ao fazer isso, você permite que seu app use a funcionalidade mais robusta oferecida pela v3. Você também vai simplificar seus esforços de migração futuros quando os recursos somente da v2 que serão compatíveis com a v3 forem lançados.