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

Le nouveau système de commentaires YouTube, lancé en novembre 2013 et basé sur Google+, permet aux utilisateurs de 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.

Les nouveaux commentaires ne sont actuellement pas pris en charge dans la version 3 de l'API YouTube Data. Toutefois, vous pouvez continuer à utiliser l'ancienne version (v2) de l'API, en prenant connaissance des quelques mises en garde ci-dessous et en présentant les avantages décrits ci-dessus.

Nous vous recommandons de vérifier que votre intégration continue de fonctionner maintenant que nous sommes passés au nouveau système de commentaires et de nous alerter si vous rencontrez des bugs (problèmes de fichier 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 par 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 requête de flux de commentaires authentifiée et non authentifiée renvoie les mêmes résultats. L'API accepte un flux de commentaires personnalisé qui inclut les 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 illustré 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+ proposent des fils de discussion. Qu'est-ce que cela signifie pour les réponses aux commentaires YouTube ?

Les réponses aux commentaires effectuées avant la transition apparaissent désormais comme des 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 du flux de commentaires YouTube représente un commentaire de nouveau style, elle contient une balise <yt:googlePlusUserId>. Si cette balise est présente et que le commentaire comporte des réponses (il vous suffit de vérifier l'élément <yt:replyCount>), vous pouvez analyser l'ID d'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 laisse 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.

SUP de l'ancienne API continue-t-il 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é, ils n'apparaissent pas dans la page "Signaler un problème".