Modifications des commentaires dans l'ancienne API YouTube Data v2

Jeremy Walker, équipe API YouTube
Septembre 2013 (mise à jour le 02/12/2013)

Introduction

Créé en novembre 2013 et fourni par Google+, le nouveau système de commentaires YouTube permet aux utilisateurs YouTube de récupérer beaucoup plus de commentaires par vidéo qu'auparavant. Le nouveau système facilite également la recherche de conversations pertinentes, car les commentaires sont classés par ordre de pertinence pour chaque utilisateur.

Bien que les nouveaux commentaires ne soient actuellement pas disponibles dans l'API YouTube Data v3, vous pouvez continuer à utiliser l'ancienne version de l'API (v2), avec quelques mises en garde décrites ci-dessous (et 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 d'ajout de commentaires. De plus, si vous rencontrez des bugs, signalez-nous les problèmes sur youtube.com/dev. Merci !

Questions fréquentes

Qu'en est-il des commentaires publiés avant la transition ?

Les commentaires publiés avant la transition ont été transférés vers le nouveau système fourni par 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 recevez 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 classés par défaut dans l'ordre chronologique par défaut. Toutefois, vous pouvez toujours classer 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 les bonnes pratiques standards d'utilisation des liens next et previous dans le flux de commentaires pour parcourir les commentaires. Ce faisant, vous aurez également l'avantage de pouvoir parcourir beaucoup plus de commentaires qu'auparavant.

Si vous définissez explicitement une valeur pour start-index à 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é et une demande de flux de commentaires non authentifié renverront les mêmes résultats. L'API accepte un flux de commentaires personnalisé qui inclut des posts non publics. Pour obtenir ce flux, envoyez simplement une requête authentifiée et définissez 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 indiquant 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 la version 2 de l'API, vous devez remplir 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 le permettent par défaut).

Si l'une de ces conditions n'est pas respectée, 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 sur YouTube ?

Les réponses aux commentaires faites avant la transition s'affichent désormais comme des commentaires normaux. De plus, il n'est plus possible de répondre directement aux commentaires via l'API YouTube. Pour le moment, il est impossible de répondre à un nouveau commentaire via l'API YouTube.

Les réponses aux nouveaux commentaires YouTube via les sites et applications YouTube et Google+ ne sont pas renvoyées avec le flux de commentaires de l'ancienne API. Vous pouvez toutefois obtenir les réponses via les API Google+.

Si une entrée du flux de commentaires YouTube représente un commentaire d'un 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 identifiant 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+ apparaît en gras dans une entrée de 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 de commentaires via l'API YouTube ne génère pas de post dans votre flux Google+ et ne génère pas non plus de notification Google+.

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

Non, pas pour l'instant.

Est-il toujours possible d'ajouter des commentaires dans l'ancienne API à l'aide du protocole SUP ?

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