Alterações nos comentários da API de dados do YouTube v2 legada

Jeremy Walker, Equipe da API do 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 com a tecnologia do Google+, permite que os usuários do YouTube recuperem muito mais comentários por vídeo do que conseguiam antes. O novo sistema também facilita a localização de conversas relevantes, porque 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 de dados do YouTube v3, 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 integração continua funcionando agora que mudamos para o novo sistema de comentários e nos avise se encontrar bugs (problemas de arquivo em youtube.com/dev). Valeu!

Perguntas frequentes

O que acontecia 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 ordenados por relevância, conforme indicado no comunicado.* Desde a mudança para o novo sistema de comentários, os comentários não estão mais em ordem cronológica por padrão. No entanto, ainda é possível ordenar os comentários cronologicamente. Para isso, defina o valor do parâmetro orderby como published na sua solicitação de API, conforme mostrado neste exemplo:

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

Siga a prática recomendada padrão de usar os links next e previous no feed de comentários para percorrer os comentários. Ao fazer isso, você também vai poder ler muitos mais comentários do que antes.

Se você definir explicitamente um valor para start-index para percorrer o feed de comentários (não recomendado), isso poderá causar um comportamento inconsistente e você só vai 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 pessoal. Em outras palavras, uma solicitação de feed de comentários autenticada e não autenticada vai retornar os mesmos resultados. A API oferece suporte a um feed de comentários personalizado que inclui postagens não públicas. Para receber esse feed, basta fazer uma solicitação autenticada e definir o valor do parâmetro relevant-to-me como true na solicitação da 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 demonstra o formato do novo feed?

Todos os feeds de comentários 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 em cronologia: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Ainda posso criar um comentário usando a API?

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

  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 legados oferecem suporte a isso por padrão)

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

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

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

As respostas aos comentários do YouTube no novo estilo feitas 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, é possível receber as respostas reais pelas APIs do Google+.

Se uma entrada do feed de comentários do YouTube representar um comentário de estilo novo, a entrada conterá uma tag <yt:googlePlusUserId>. Se essa tag estiver presente e o comentário tiver respostas (basta verificar o elemento <yt:replyCount>), você poderá analisar o ID de atividade do Google+ na tag <id> da entrada. Você pode usar esse ID para chamar o método comments:list da API Google+ e extrair 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 do 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 do YouTube?

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

Os comentários continuam aparecendo no feed de atividades desde a mudança para o novo sistema?

Agora não.

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

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