CommentThreads

Une ressource commentThread contient des informations sur un fil de commentaires YouTube, qui comprennent un commentaire de premier niveau et les réponses à ce commentaire, le cas échéant. Une ressource commentThread peut représenter des commentaires sur une vidéo ou une chaîne.

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. Notez également que certains commentaires n'ont pas de réponse.

Méthodes

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

list
Renvoie une liste de fils de commentaires qui correspondent aux paramètres de requête de l'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 ci-dessous présente 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 de l'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.
  • Si les commentaires concernent une vidéo, la valeur identifie la chaîne qui a mis en ligne la vidéo. La propriété snippet.videoId identifie la vidéo.
  • Si les commentaires font référence à la chaîne elle-même, la propriété snippet.videoId n'aura pas de valeur.
snippet.videoId string
ID de la vidéo à laquelle les commentaires font référence, le cas échéant. Si cette propriété n'est pas présente ou n'a pas de valeur, le fil de discussion s'applique à la chaîne et non à une vidéo spécifique.
snippet.topLevelComment object
Commentaire de premier niveau 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 au commentaire de premier niveau.
snippet.isPublic boolean
Ce paramètre indique si le fil de discussion, y compris tous ses commentaires et réponses, 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.
replies.comments[] list
Liste d'une ou de 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 dans la liste soit égal à la valeur de la propriété snippet.totalReplyCount, la liste des réponses ne constitue 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 niveau supérieur, vous devez appeler la méthode comments.list et utiliser le paramètre de requête parentId pour identifier le commentaire pour lequel vous souhaitez récupérer les réponses.