Crea un nuovo commento di primo livello. Per aggiungere una risposta a un commento esistente, usa invece il metodo comments.insert
.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 50 unità.
Casi d'uso comuni
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/youtube/v3/commentThreads
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/youtube.force-ssl |
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 identifica le proprietà che saranno incluse nella risposta dell'API. Imposta il valore del parametro su snippet . La parte snippet ha un costo della quota di 2 unità.Il seguente elenco contiene i nomi part che puoi includere nel valore del parametro:
|
Corpo della richiesta
Specifica una risorsacommentThread nel corpo della richiesta.
Per questa risorsa, devi specificare un valore per le seguenti proprietà:
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
Risposta
Se l'esito è positivo, questo metodo restituisce una risorsacommentThread nel corpo della risposta.
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) |
channelOrVideoIdMissing |
Ogni thread di commenti deve essere collegato a un video. Assicurati che la risorsa specifichi i valori per le proprietà snippet.channelId e snippet.videoId . Nella pagina di visualizzazione di un video viene visualizzato un commento su un video. |
badRequest (400) |
commentTextRequired |
La risorsa comment inserita deve specificare un valore per la proprietà snippet.topLevelComment.snippet.textOriginal . I commenti non possono essere vuoti. |
badRequest (400) |
commentTextTooLong |
La risorsa comment che viene inserita contiene troppi caratteri nella proprietà snippet.topLevelComment.snippet.textOriginal . |
badRequest (400) |
invalidCommentThreadMetadata |
I metadati della richiesta non sono validi. |
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) |
forbidden |
Autorizzazioni insufficienti. Impossibile creare il thread dei commenti. La richiesta potrebbe non essere autorizzata in modo adeguato. |
forbidden (403) |
ineligibleAccount |
Per poter inserire un commento o un thread di commenti, l'account YouTube utilizzato per autorizzare la richiesta API deve essere unito all'Account Google dell'utente. |
notFound (404) |
channelNotFound |
Impossibile trovare il canale specificato. Controlla il valore della proprietà snippet.channelId per assicurarti che sia corretto. |
notFound (404) |
videoNotFound |
Impossibile trovare il video specificato. Controlla il valore della proprietà snippet.videoId per assicurarti che sia corretto. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.