Crea un nuovo commento di primo livello. Per aggiungere una risposta a un commento esistente, utilizza il metodo comments.insert
.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 50 unità.
Casi d'uso comuni
Risorse richieste:
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
Nella tabella seguente sono elencati i parametri supportati dalla query. Tutti i parametri elencati sono parametri di ricerca.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
part |
string Il parametro part identifica le proprietà che verranno incluse nella risposta dell'API. Imposta il valore del parametro su snippet . La parte snippet ha un costo quota di 2 unità.Il seguente elenco contiene i nomi part che puoi includere nel valore parametro:
|
Corpo della richiesta
Fornisci una risorsa threadThread nel corpo della richiesta. Per la risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.channelId
snippet.topLevelComment.snippet.textOriginal
-
Puoi impostare i valori delle seguenti proprietà:
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa threadThread 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 maggiori dettagli, consulta la documentazione sui messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Ogni thread di commenti deve essere collegato a un canale o a 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 può trattarsi 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 |
Impossibile creare il thread di commenti a causa di autorizzazioni insufficienti. La richiesta potrebbe non essere autorizzata correttamente. |
forbidden (403) |
ineligibleAccount |
Per 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.