CommentThreads

Une ressource commentThread contient des informations sur un fil de commentaires YouTube, qui comprend un commentaire de premier niveau et, le cas échéant, des réponses à ce commentaire. Une ressource commentThread représente les commentaires sur une vidéo.

Le commentaire de premier niveau et les réponses sont en réalité des ressources comment imbriquées dans la ressource commentThread. La ressource commentThread ne contient pas nécessairement toutes les réponses à un commentaire. Vous devez utiliser la méthode comments.list si vous souhaitez récupérer toutes les réponses à un commentaire particulier. Certains commentaires n'ont pas de réponse.

Méthodes

L'API est compatible avec les méthodes suivantes pour les ressources commentThreads:

liste

Renvoie une liste de fils de commentaires correspondant aux paramètres de requête API. Essayer

insérer

Crée un commentaire de premier niveau. Pour ajouter une réponse à un commentaire existant, utilisez plutôt la méthode comments.insert. Essayer maintenant

Représentation des ressources

La structure JSON indique le format d'une ressource commentThreads:

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
kind	string Identifie le type de ressource d'API. La valeur sera youtube#commentThread.
etag	etag Etag de cette ressource.
id	string ID utilisé par YouTube pour identifier de façon unique le fil de commentaires.
snippet	object L'objet snippet contient des informations de base sur le fil de commentaires. Il contient également le commentaire de premier niveau du fil de discussion, qui est une ressource comment.
snippet.channelId	string Chaîne YouTube associée aux commentaires du fil de discussion. La propriété snippet.videoId identifie la vidéo.
snippet.videoId	string ID de la vidéo à laquelle les commentaires font référence.
snippet.topLevelComment	object Commentaire principal du fil de discussion. La valeur de la propriété est une ressource comment.
snippet.canReply	boolean Ce paramètre indique si le lecteur actuel peut répondre au fil de discussion.
snippet.totalReplyCount	unsigned integer Nombre total de réponses envoyées en réponse au commentaire de premier niveau.
snippet.isPublic	boolean Ce paramètre indique si le fil de discussion, y compris l'ensemble des commentaires et des réponses, est visible par tous les utilisateurs de YouTube.
replies	object L'objet replies est un conteneur qui contient une liste de réponses au commentaire, le cas échéant. La propriété replies.comments représente la liste des commentaires elle-même.
replies.comments[]	list Liste contenant une ou plusieurs réponses au commentaire principal. Chaque élément de la liste est une ressource comment. La liste contient un nombre limité de réponses. À moins que le nombre d'éléments de la liste soit égal à la valeur de la propriété snippet.totalReplyCount, la liste de réponses n'est qu'un sous-ensemble du nombre total de réponses disponibles pour le commentaire de premier niveau. Pour récupérer toutes les réponses du commentaire de premier niveau, vous devez appeler la méthode comments.list et utiliser le paramètre de requête parentId afin d'identifier le commentaire pour lequel vous souhaitez récupérer les réponses.