Comentarios sobre los cambios en la versión heredada de la API de YouTube Data

Jeremy Walker, equipo de la API de YouTube
Septiembre de 2013 (actualización: 2/12/2013)

Introducción

El nuevo sistema de comentarios de YouTube, que se lanzó en noviembre de 2013 y está potenciado por Google+, permite que los usuarios de YouTube recuperen 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 cada usuario.

Si bien actualmente la versión 3 de la API de datos de YouTube no admite los nuevos comentarios, puedes seguir utilizando la versión anterior de la API (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 siga funcionando ahora que cambiamos al nuevo sistema de comentarios y nos alertes si encuentras algún error (problemas con archivos 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+.

¿Sigue disponible el feed de comentarios?

Sí, por ejemplo, si usas la API para recuperar los comentarios de un video, obtienes un feed de comentarios ordenados por relevancia, como se indica en el anuncio.* Desde el cambio al nuevo sistema de comentarios, los comentarios ya no se muestran 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 tu 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 estándar de usar los vínculos next y previous en el feed de comentarios para navegar a través de los comentarios. De esta forma, también obtendrás el beneficio adicional de poder paginar muchos más comentarios que antes.

Si estableces de forma explícita un valor para start-index para paginar el feed de comentarios (no se recomienda), es posible que se produzca un comportamiento incoherente y solo se devuelva una pequeña cantidad de comentarios.

Actualización (10/11/2013):

* De forma predeterminada, los feeds de comentarios se ordenan por relevancia general, no por relevancia personal. En otras palabras, una solicitud de feed de comentarios autenticada y una no autenticada mostrarán los mismos resultados. La API admite un feed de comentarios personalizado que incluye publicaciones no públicas. Para obtener este feed, simplemente realiza una solicitud autenticada y establece el valor del parámetro relevant-to-me en true en tu 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 un feed que muestra el formato del feed nuevo?

Ahora, todos los feeds de comentarios admiten el formato nuevo. A continuación, se incluyen algunos ejemplos.

  • Feed basado en la relevancia: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Feed basado en el orden cronológico: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

¿Puedo crear un comentario a través de 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 debe enviarse a través de HTTPS (las versiones actuales de las bibliotecas cliente heredadas lo admiten de forma predeterminada).

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

Los comentarios potenciados por Google+ ofrecen la función de 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. Además, ya no se admite responder directamente los comentarios a través de la API de YouTube. En este momento, no podemos responder a un comentario de estilo nuevo con la API de YouTube.

Las respuestas a los comentarios de YouTube de nuevo estilo a través de 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 a través de las API de Google+.

Si una entrada del feed de comentarios de YouTube representa un comentario de estilo nuevo, la entrada contendrá una etiqueta <yt:googlePlusUserId>. Si esa etiqueta está presente y el comentario tiene respuestas (solo verifica el elemento <yt:replyCount>), puedes analizar el ID de la actividad de Google+ desde 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 respuestas recientes a ese comentario.

En el siguiente extracto, se muestra cómo aparece un ID de actividad de Google+, que se muestra en texto en negrita, en una entrada de un 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 hago un comentario a través de la API de YouTube?

Si dejas un comentario a través de la API de YouTube, no se generará una publicación en tu feed de Google+ ni se creará una notificación de Google+.

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

No en este momento.

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

No, no se muestran en los comentarios. SUP se basa en el feed de actividad del usuario. Como los comentarios ya no están en el feed de actividad, no aparecen en SUP.