Una risorsa commentThread
contiene informazioni su un thread di commenti di YouTube, che comprende un commento di primo livello e le risposte, se presenti, al commento in questione. Una risorsa commentThread
rappresenta i commenti su un video.
Sia il commento di primo livello che le risposte sono in realtà comment
risorse nidificate all'interno della risorsa commentThread
. La risorsa commentThread
non contiene necessariamente tutte le risposte a un commento e devi utilizzare il metodo comments.list
se desideri recuperare tutte le risposte per un determinato commento. Alcuni commenti non hanno risposte.
Metodi
L'API supporta i seguenti metodi per le risorse commentThreads
:
- list
- Restituisci un elenco di thread di commenti che corrispondono ai parametri di richiesta API. Prova subito.
- inserisci
- Crea un nuovo commento di primo livello. Per aggiungere una risposta a un commento esistente, usa il metodo
comments.insert
. Prova subito.
Rappresentazione della risorsa
La struttura JSON mostra il formato di una risorsa 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 ] } }
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#commentThread . |
etag |
etag L'Etag di questa risorsa. |
id |
string L'ID utilizzato da YouTube per identificare in modo univoco il thread del commento. |
snippet |
object L'oggetto snippet contiene i dettagli di base sul thread dei commenti. Contiene anche il commento di primo livello del thread, che è una risorsa comment . |
snippet.channelId |
string Il canale YouTube associato ai commenti nel thread. La proprietà snippet.videoId identifica il video. |
snippet.videoId |
string L'ID del video a cui fanno riferimento i commenti. |
snippet.topLevelComment |
object Il commento di primo livello del thread. Il valore della proprietà è una risorsa comment . |
snippet.canReply |
boolean Questa impostazione indica se il visualizzatore corrente può rispondere al thread. |
snippet.totalReplyCount |
unsigned integer Il numero totale di risposte che sono state inviate in risposta al commento principale. |
snippet.isPublic |
boolean Questa impostazione indica se il thread, inclusi tutti i relativi commenti e risposte ai commenti, è visibile a tutti gli utenti di YouTube. |
replies |
object L'oggetto replies è un contenitore che contiene un elenco di risposte al commento, se presenti. La proprietà replies.comments rappresenta l'elenco dei commenti. |
replies.comments[] |
list Un elenco di una o più risposte al commento di primo livello. Ogni elemento dell'elenco è una risorsa comment .L'elenco contiene un numero limitato di risposte e, a meno che il numero di elementi nell'elenco non corrisponda al valore della proprietà snippet.totalReplyCount , l'elenco delle risposte è solo un sottoinsieme del numero totale di risposte disponibili per il commento di primo livello. Per recuperare tutte le risposte al commento di primo livello, devi chiamare il metodo comments.list e utilizzare il parametro di richiesta parentId per identificare il commento per cui vuoi recuperare le risposte. |