CommentThreads

Una risorsa commentThread contiene informazioni su un thread di commenti di YouTube, che comprende un commento di primo livello e le eventuali risposte a quel commento. Una risorsa commentThread può rappresentare i commenti su un video o su un canale.

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. Se vuoi recuperare tutte le risposte a un determinato commento, devi utilizzare il metodo comments.list. Inoltre, tieni presente che alcuni commenti non hanno risposte.

Metodi

L'API supporta i seguenti metodi per le risorse di commentThreads:

list

Restituisce 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, utilizza il metodo comments.insert. Prova subito.

Rappresentazione delle risorse

La struttura JSON seguente 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à che vengono 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 dettagli di base sul thread di 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. Se i commenti riguardano un video, il valore identifica il canale che lo ha caricato. La proprietà snippet.videoId identifica il video. Se i commenti fanno riferimento al canale stesso, la proprietà snippet.videoId non avrà alcun valore.
snippet.videoId	string L'ID del video a cui fanno riferimento i commenti, se presenti. Se questa proprietà non è presente o non ha un valore, il thread viene applicato al canale e non a un video specifico.
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 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, 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 nell'elenco è una risorsa comment. L'elenco contiene un numero limitato di risposte e, a meno che il numero di elementi nell'elenco 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 per il 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.