Mudanças em comentários na API de dados legada do YouTube v2

Jeremy Walker, equipe da API YouTube
setembro de 2013 (atualizado em 02/12/2013)

Introdução

O novo sistema de comentários do YouTube, lançado em novembro de 2013 e disponibilizado pelo Google+, permite que os usuários do YouTube recuperem muito mais comentários por vídeo do que antes. O novo sistema também facilita a localização de conversas significativas, já que os comentários são ordenados por relevância para usuários individuais.

Os novos comentários ainda não são compatíveis com a API Data v3 do YouTube, mas você pode continuar usando a versão mais antiga da API (v2) com algumas ressalvas descritas abaixo (e os benefícios mencionados acima).

Recomendamos que você confirme se a sua integração continua funcionando agora que mudamos para o novo sistema de comentários e nos avise se você encontrar bugs (problemas no arquivo em youtube.com/dev). Agradeço sua atenção.

Perguntas frequentes

O que aconteceu com os comentários postados antes da transição?

Os comentários postados antes da transição foram migrados para o novo sistema do Google+.

O feed de comentários ainda está disponível?

Sim. Por exemplo, se você usar a API para recuperar os comentários de um vídeo, vai receber um feed de comentários ordenado por relevância, conforme mencionado no aviso.* Desde a troca para o novo sistema de comentários, por padrão, os comentários não estão mais em ordem cronológica. No entanto, ainda é possível ordenar os comentários em ordem cronológica definindo o valor do parâmetro orderby como published na solicitação de API, conforme mostrado no exemplo a seguir:

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

Siga as práticas recomendadas padrão para usar os links next e previous no feed de comentários. Ao fazer isso, você também terá a vantagem adicional de poder percorrer mais comentários do que antes.

Se você definir explicitamente um valor para start-index como a página no feed de comentários (não recomendado), isso poderá causar um comportamento inconsistente e você só receberá um pequeno número de comentários.

Atualização (10/11/2013):

* Por padrão, os feeds de comentários são classificados por relevância geral, não por relevância pessoal. Em outras palavras, uma solicitação de feed de comentário autenticado e uma não autenticada retornará os mesmos resultados. A API oferece suporte a um feed de comentários personalizado que inclui postagens não públicas. Para acessar esse feed, basta fazer uma solicitação autenticada e definir o valor do parâmetro relevant-to-me como true na sua solicitação de API, conforme mostrado no exemplo a seguir: 

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true

Existe um feed que demonstre o formato do novo feed?

Todos os feeds de comentários já são compatíveis com o novo formato. Veja alguns exemplos abaixo.

  • Feed com base na relevância: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Feed baseado na ordem cronológica: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Ainda posso criar um comentário usando a API?

Sim, mas para escrever novos comentários com a API v2, há vários requisitos:

  1. O usuário autenticado precisa ter um canal do YouTube vinculado a uma conta do Google+ (detalhes da API).
  2. A solicitação precisa ser enviada por HTTPS (as versões atuais das bibliotecas de cliente legadas são compatíveis com essa configuração por padrão).

Se um desses requisitos não for atendido, a API retornará um erro.

Os comentários com a tecnologia do Google+ oferecem conversas. O que isso significa para as respostas aos comentários do YouTube?

As respostas enviadas antes da transição agora aparecem como comentários normais. Além disso, não é mais possível responder diretamente aos comentários usando a API YouTube. No momento, não há como responder a um comentário no estilo novo usando a API YouTube.

As respostas a novos comentários do YouTube nos sites e apps do YouTube e do Google+ não são retornadas com o feed de comentários da API legada. No entanto, você pode receber as respostas reais usando as APIs do Google+.

Se uma entrada do feed de comentários do YouTube representar um comentário no estilo novo, a entrada conterá uma tag <yt:googlePlusUserId>. Se essa tag estiver presente e o comentário tiver alguma resposta (basta verificar o elemento <yt:replyCount>), você poderá analisar o ID de atividade do Google+ pela tag <id> da entrada. Você pode usar esse ID para chamar o método comments:list da API Google+ e recuperar uma lista de respostas recentes a esse comentário.

O trecho abaixo demonstra como um ID de atividade do Google+, mostrado em negrito, aparece em uma entrada de feed de comentários:

<entry>
  <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id>
  <yt:googlePlusUserId>123456789</yt:googlePlusUserId>
  <yt:replyCount>4</yt:replyCount>
  <yt:channelId>UCxxxx_xxxxx</yt:channelId>
  ...
</entry>

O que acontece no Google+ quando faço um comentário usando a API YouTube?

Fazer um comentário pela API do YouTube não gera uma postagem no stream do Google+ nem cria uma notificação do Google+.

Os comentários continuam a aparecer no feed de atividades desde a troca para o novo sistema de comentários?

Agora não.

O SUP na API legada continua funcionando para comentários?

Não, não por comentários. O SUP depende do feed de atividade do usuário. Como os comentários não estão mais no feed de atividades, eles não serão exibidos no SUP.