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, les réponses à ce commentaire. Une ressource commentThread représente les commentaires laissés sur une vidéo.

Le commentaire de premier niveau et les réponses sont en fait 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 reçu aucune réponse.

Méthodes

L'API accepte les méthodes suivantes pour les ressources commentThreads:

liste
Renvoie une liste de fils de commentaires correspondant aux paramètres de requête de l'API. Essayer
insérer
Crée un commentaire général. 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 général du fil de discussion. La valeur de la propriété est une ressource comment.
snippet.canReply boolean
Ce paramètre indique si l'utilisateur 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 aux commentaires, est visible par tous les utilisateurs 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 d'une ou plusieurs réponses au commentaire de premier niveau. 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 ne corresponde à la valeur de la propriété snippet.totalReplyCount, la liste des réponses ne représente 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 au 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.