CommentThreads: list

Restituisce un elenco di thread di commenti che corrispondono ai parametri della richiesta API.

Impatto della quota: una chiamata a questo metodo ha un costo della quota di 1 unità.

Casi d'uso comuni

Richiesta

Richiesta HTTP

GET https://www.googleapis.com/youtube/v3/commentThreads

Parametri

La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.

Parametri
Parametri obbligatori
part string
Il parametro part specifica un elenco separato da virgole di una o più proprietà delle risorse commentThread che verranno incluse nella risposta dell'API.

Il seguente elenco contiene i part nomi che puoi includere nel valore del parametro:
  • id
  • replies
  • snippet
Filtri (specificare esattamente uno dei seguenti parametri)
allThreadsRelatedToChannelId string
Il parametro allThreadsRelatedToChannelId indica all'API di restituire tutti i thread di commenti associati al canale specificato.
id string
Il parametro id specifica un elenco separato da virgole di ID thread di commenti per le risorse che devono essere recuperate.
videoId string
Il parametro videoId indica all'API di restituire i thread di commenti associati all'ID video specificato.
Parametri facoltativi
maxResults unsigned integer
Il parametro maxResults specifica il numero massimo di elementi da restituire nel set di risultati.

Nota: l'uso di questo parametro non è supportato in combinazione con il parametro id. I valori accettati sono compresi tra 1 e 100. Il valore predefinito è 20.
moderationStatus string
Questo parametro può essere utilizzato solo in una richiesta autorizzata correttamente. Imposta questo parametro per limitare i thread di commenti restituiti a un determinato stato di moderazione.

Nota: l'uso di questo parametro non è supportato in combinazione con il parametro id. Il valore predefinito è published.

I valori accettati sono:
  • heldForReview - Recupera i thread di commenti in attesa di revisione da parte di un moderatore. È possibile includere un thread di commenti nella risposta se il commento di primo livello o almeno una delle risposte a tale commento sono in attesa di revisione.
  • likelySpam - Recupera i thread di commenti classificati come spam. È possibile includere un thread di commenti nella risposta se il commento di primo livello o almeno una delle risposte a quel commento sono considerati spam.
  • published - Recupera i thread di commenti pubblicati. Questo è il valore predefinito. È possibile includere un thread di commenti nella risposta se il relativo commento di primo livello è stato pubblicato.
order string
Il parametro order specifica l'ordine in cui la risposta dell'API deve elencare i thread di commenti. I valori validi sono:
  • time: i thread dei commenti sono ordinati per data. Questo è il comportamento predefinito.
  • relevance: i thread dei commenti sono ordinati in base alla pertinenza.
Nota: l'uso di questo parametro non è supportato in combinazione con il parametro id.
pageToken string
Il parametro pageToken identifica una pagina specifica da restituire del set di risultati. In una risposta dell'API, la proprietà nextPageToken identifica la pagina successiva del risultato recuperabile.

Nota: l'uso di questo parametro non è supportato in combinazione con il parametro id.
searchTerms string
Il parametro searchTerms indica all'API di limitare la risposta dell'API in modo che contenga solo i commenti che contengono i termini di ricerca specificati.

Nota: non è supportato l'uso di questo parametro in combinazione con il parametro id.
textFormat string
Imposta il valore di questo parametro su html o plainText per indicare all'API di restituire i commenti lasciati dagli utenti in formato HTML o in testo normale. Il valore predefinito è html.

I valori accettati sono:
  • html: restituisce i commenti in formato HTML. Questo è il valore predefinito.
  • plainText: restituisce i commenti in formato di testo normale.

Corpo della richiesta

Non fornire il corpo della richiesta quando chiami questo metodo.

Risposta

Se l'esito è positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "kind": "youtube#commentThreadListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    commentThread 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#commentThreadListResponse.
etag etag
L'Etag di questa risorsa.
nextPageToken string
Il token che può essere utilizzato come valore del parametro pageToken per recuperare la pagina successiva nel set di risultati.
pageInfo object
L'oggetto pageInfo incapsula le informazioni sul paging per il set di risultati.
pageInfo.totalResults integer
Il numero totale di risultati nel set di risultati.
pageInfo.resultsPerPage integer
Il numero di risultati inclusi nella risposta dell'API.
items[] list
Un elenco di thread di commenti che corrispondono ai criteri della richiesta.

Errori

La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la documentazione relativa ai messaggi di errore.

Tipo di errore Dettagli errore Descrizione
badRequest (400) operationNotSupported Il filtro id è compatibile soltanto con i commenti basati su Google+.
badRequest (400) processingFailure Il server API non è riuscito a elaborare la richiesta. Anche se si tratta di un errore temporaneo, di solito indica che l'input della richiesta non è valido. Controlla la struttura della risorsa commentThread nel corpo della richiesta per assicurarti che sia valida.
forbidden (403) commentsDisabled Il video identificato dal parametro videoId ha disattivato i commenti.
forbidden (403) forbidden Impossibile recuperare uno o più thread di commenti richiesti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata in modo adeguato.
notFound (404) channelNotFound Impossibile trovare il canale identificato dal parametro allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Impossibile trovare uno o più thread di commenti specificati. Controlla i valori del parametro id della richiesta per assicurarti che siano corretti.
notFound (404) videoNotFound Impossibile trovare il video identificato dal parametro videoId.

Prova.

Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.