Una risorsa commentThread
contiene informazioni su un thread di commenti di YouTube, composto da un commento di primo livello e delle eventuali risposte a quel commento. Una risorsa commentThread
rappresenta i commenti su un video.
Sia il commento di primo livello sia 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. Devi utilizzare il metodo comments.list
se vuoi recuperare tutte le risposte a un commento specifico. Non è disponibile una risposta per alcuni commenti.
Metodi
L'API supporta i seguenti metodi per le risorse commentThreads
:
- list
- Restituisci un elenco di thread di commenti che corrispondono ai parametri della richiesta API. Prova subito.
- inserire
- Crea un nuovo commento di primo livello. Per aggiungere una risposta a un commento esistente, usa invece il metodo
comments.insert
. Prova subito.
Rappresentazione delle risorse
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 di commenti. |
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 si riferiscono 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 lo spettatore corrente può rispondere al thread. |
snippet.totalReplyCount |
unsigned integer Il numero totale di risposte inviate in risposta al commento di primo livello. |
snippet.isPublic |
boolean Questa impostazione indica se il thread, inclusi tutti i commenti e le 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 stessi. |
replies.comments[] |
list Un elenco di una o più risposte al commento di primo livello. Ogni elemento dell'elenco è una risorsa di 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 di risposte è solo un sottoinsieme del numero totale di risposte disponibili per il commento di primo livello. Per recuperare tutte le risposte relative al commento di primo livello, devi chiamare il metodo comments.list e utilizzare il parametro di richiesta parentId per identificare il commento per il quale vuoi recuperare le risposte. |