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