Cambios en los comentarios de la versión 2 de la API de datos heredada de YouTube

Jeremy Walker, equipo de la API de YouTube
septiembre de 2013 (última actualización: 02/12/2013)

Introducción

El nuevo sistema de comentarios de YouTube, que se lanzó en noviembre de 2013 con la tecnología de Google+, permite a los usuarios de YouTube recuperar muchos más comentarios por video que antes. El nuevo sistema también facilita la búsqueda de conversaciones significativas, ya que los comentarios se ordenan por relevancia para usuarios individuales.

Si bien actualmente los comentarios nuevos no son compatibles con la versión 3 de la API de datos de YouTube, puedes seguir usando la versión anterior (v2) con algunas advertencias, que se detallan a continuación (y los beneficios que se mencionaron anteriormente).

Te recomendamos que confirmes que tu integración sigue funcionando ahora que cambiamos al nuevo sistema de comentarios y que nos informes si encuentras algún error (informa los problemas en youtube.com/dev). Gracias.

Preguntas frecuentes

¿Qué sucedió con los comentarios publicados antes de la transición?

Los comentarios publicados antes de la transición se migraron al nuevo sistema con la tecnología de Google+.

¿El feed de comentarios todavía está disponible?

Sí. Por ejemplo, si usas la API para recuperar los comentarios de un video, recibirás un feed de comentarios ordenados por relevancia según se indica en el anuncio.* Desde el cambio al nuevo sistema de comentarios, los comentarios ya no están en orden cronológico de forma predeterminada. Sin embargo, puedes ordenar los comentarios de forma cronológica si estableces el valor del parámetro orderby en published en la solicitud a la API, como se muestra en el siguiente ejemplo:

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

Te recomendamos que sigas la práctica recomendada de usar los vínculos next y previous en el feed de comentarios para paginar los comentarios. De esta manera, también obtendrás el beneficio adicional de poder desplazarte a través de muchos más comentarios de los que podías hacer antes.

Si configuras de manera explícita un valor para start-index a fin de paginar el feed de comentarios (no recomendado), es posible que el comportamiento sea inconsistente y que solo se muestren algunos comentarios.

Actualización (10/11/2013):

* De forma predeterminada, los feeds de comentarios se ordenan por relevancia general y no por relevancia personal. En otras palabras, una solicitud de feed de comentarios autenticada y no autenticada mostrará los mismos resultados. La API admite un feed de comentarios personalizado que incluye publicaciones no públicas. Para obtener este feed, realiza una solicitud autenticada y establece el valor del parámetro relevant-to-me en true en la solicitud a la API, como se muestra en el siguiente ejemplo: 

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

¿Hay algún feed que demuestre el formato del nuevo?

Todos los feeds de comentarios ahora admiten el nuevo formato. Estos son algunos ejemplos.

  • Feed basado en relevancia: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Feed basado en cronología: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

¿Aún puedo crear un comentario mediante la API?

Sí, pero para escribir comentarios nuevos con la API v2, existen varios requisitos:

  1. El usuario autenticado debe tener un canal de YouTube vinculado a una cuenta de Google+ (detalles de la API).
  2. La solicitud se debe enviar a través de HTTPS (las versiones actuales de las bibliotecas cliente heredadas son compatibles de forma predeterminada).

Si no se cumple alguno de estos requisitos, la API muestra un error.

Los comentarios con la tecnología de Google+ ofrecen conversaciones. ¿Qué significa esto para las respuestas a los comentarios de YouTube?

Las respuestas a los comentarios realizadas antes de la transición ahora aparecen como comentarios normales. Tampoco se puede responder directamente a los comentarios a través de la API de YouTube. Por el momento, no se pueden responder comentarios en un estilo nuevo mediante la API de YouTube.

Las respuestas a los comentarios nuevos de YouTube en los sitios y las apps de YouTube y Google+ no se muestran en el feed de comentarios de la API heredada. Sin embargo, puedes obtener las respuestas reales por medio de las API de Google+.

Si una entrada del feed de comentarios de YouTube representa un comentario de estilo nuevo, la entrada contiene una etiqueta <yt:googlePlusUserId>. Si la etiqueta está presente y el comentario tiene respuestas (solo revisa el elemento <yt:replyCount>), podrás analizar el ID de la actividad de Google+ que aparece en la etiqueta <id> de la entrada. Puedes usar ese ID para invocar el método comments:list de la API de Google+ para recuperar una lista de las respuestas recientes a ese comentario.

El fragmento que aparece a continuación demuestra cómo aparece un ID de actividad de Google+, en negrita, en una entrada del feed de comentarios:

<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>

¿Qué sucede en Google+ cuando realizo un comentario a través de la API de YouTube?

Hacer un comentario a través de la API de YouTube no genera una publicación en tus novedades de Google+ ni crea una notificación de Google+.

¿Los comentarios siguen apareciendo en el feed de actividades desde el cambio al nuevo sistema de comentarios?

No en este momento.

¿SUP en la API heredada sigue funcionando para los comentarios?

No, no para comentarios. SUP se basa en el feed de actividad del usuario. Como los comentarios ya no se encuentran en el feed de actividad, no aparecen en SUP.