Modifications apportées aux commentaires dans l'ancienne version 2 de l'API YouTube Data

Jeremy Walker, équipe de l'API YouTube
Septembre 2013 (mise à jour le 2/12/2013)

Introduction

Basé sur Google+, le nouveau système de commentaires YouTube, lancé en novembre 2013, permet aux utilisateurs YouTube de récupérer beaucoup plus de commentaires par vidéo qu'auparavant. Le nouveau système permet également de trouver plus facilement des conversations intéressantes, car les commentaires sont classés en fonction de leur pertinence pour chaque utilisateur.

Même si les nouveaux commentaires ne sont pas encore compatibles avec la version 3 de l'API YouTube Data, vous pouvez continuer à utiliser l'ancienne version de l'API (version 2) avec quelques restrictions décrites ci-dessous (et les avantages décrits ci-dessus).

Nous vous recommandons de confirmer que votre intégration continue de fonctionner maintenant que nous sommes passés au nouveau système de commentaires. Si vous rencontrez des bugs, contactez-nous (signalez des problèmes sur youtube.com/dev). Merci !

Questions fréquentes

Qu'est-il arrivé aux commentaires publiés avant la transition ?

Les commentaires publiés avant la transition ont été migrés vers le nouveau système basé sur Google+.

Le flux de commentaires est-il toujours disponible ?

Oui. Par exemple, si vous utilisez l'API pour récupérer les commentaires d'une vidéo, vous obtenez un flux de commentaires triés par pertinence, comme indiqué dans l'annonce*. Depuis le passage au nouveau système de commentaires, les commentaires ne sont plus affichés dans l'ordre chronologique par défaut. Toutefois, vous pouvez toujours organiser les commentaires par ordre chronologique en définissant la valeur du paramètre orderby sur published dans votre requête API, comme illustré dans l'exemple suivant :

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

Nous vous recommandons de suivre la bonne pratique standard consistant à utiliser les liens next et previous dans le flux de commentaires pour parcourir les commentaires. Vous pourrez ainsi parcourir beaucoup plus de commentaires qu'auparavant.

Si vous définissez explicitement une valeur pour start-index afin de parcourir le flux de commentaires (non recommandé), cela peut entraîner un comportement incohérent et vous ne recevrez qu'un petit nombre de commentaires.

Mise à jour (10/11/2013):

* Par défaut, les flux de commentaires sont triés par pertinence générale, et non par pertinence personnelle. En d'autres termes, une demande de flux de commentaires authentifiée et une demande de flux de commentaires non authentifiée renvoient les mêmes résultats. L'API prend en charge les flux de commentaires personnalisés incluant des posts non publics. Pour obtenir ce flux, il vous suffit d'envoyer une requête authentifiée et de définir la valeur du paramètre relevant-to-me sur true dans votre requête API, comme indiqué dans l'exemple suivant : 

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

Existe-t-il un flux qui illustre le format du nouveau flux ?

Tous les flux de commentaires sont désormais compatibles avec le nouveau format. Vous trouverez quelques exemples ci-dessous.

  • Flux basé sur la pertinence : 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Flux chronologique : 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Puis-je quand même créer un commentaire via l'API ?

Oui, mais pour écrire de nouveaux commentaires avec l'API v2, vous devez respecter plusieurs conditions :

  1. L'utilisateur authentifié doit disposer d'une chaîne YouTube associée à un compte Google+ (informations sur l'API).
  2. La requête doit être envoyée via HTTPS (les versions actuelles des anciennes bibliothèques clientes sont compatibles avec ce protocole par défaut).

Si l'une de ces conditions n'est pas remplie, l'API renvoie une erreur.

Les commentaires Google+ sont proposés sous forme de fils. Qu'est-ce que cela implique pour les réponses aux commentaires YouTube ?

Les réponses aux commentaires effectuées avant la transition apparaissent désormais sous forme de commentaires standards. De plus, il n'est plus possible de répondre directement aux commentaires via l'API YouTube. Pour le moment, il n'est pas possible de répondre à un commentaire de nouveau type via l'API YouTube.

Les réponses aux commentaires YouTube de nouvelle génération via les sites et applications YouTube et Google+ ne sont pas renvoyées avec le flux de commentaires de l'ancienne API. Toutefois, vous pouvez obtenir les réponses réelles via les API Google+.

Si une entrée de flux de commentaires YouTube représente un commentaire du nouveau style, elle contient une balise <yt:googlePlusUserId>. Si cette balise est présente et que le commentaire comporte des réponses (vérifiez simplement l'élément <yt:replyCount>), vous pouvez analyser l'identifiant de l'activité Google+ à partir de la balise <id> de l'entrée. Vous pouvez utiliser cet ID pour appeler la méthode comments:list de l'API Google+ afin de récupérer la liste des réponses récentes à ce commentaire.

L'extrait ci-dessous montre comment un ID d'activité Google+, affiché en gras, apparaît dans une entrée du flux de commentaires :

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

Que se passe-t-il sur Google+ lorsque je publie un commentaire via l'API YouTube ?

La publication d'un commentaire via l'API YouTube ne génère pas de post dans votre flux Google+ ni de notification Google+.

Les commentaires continuent-ils de s'afficher dans le flux d'activités depuis le passage au nouveau système de commentaires ?

Non, pas pour l'instant.

Les commandes SUP de l'ancienne API continuent-elles de fonctionner pour les commentaires ?

Non, pas pour les commentaires. SUP s'appuie sur le flux d'activité des utilisateurs. Comme les commentaires ne figurent plus dans le flux d'activités, ils n'apparaissent plus dans le panneau SUP.