CommentThreads

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.