CommentThreads

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.