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. |