Crea una risposta a un commento esistente. Nota:per creare un commento di primo livello, utilizza il metodo commentThreads.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/comments
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 risorsa per i commenti nel corpo della richiesta. Per questa risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.textOriginal
snippet.parentId
-
Puoi impostare i valori per le seguenti proprietà:
snippet.textOriginal
Risposta
Se l'esito è positivo, questo metodo restituisce una risorsa commento 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) |
commentTextRequired |
La risorsa comment inserita deve specificare un valore per la proprietà snippet.textOriginal . I commenti non possono essere vuoti. |
badRequest (400) |
commentTextTooLong |
La risorsa comment che viene inserita contiene troppi caratteri nella proprietà snippet.textOriginal . |
badRequest (400) |
invalidCustomEmoji |
La risorsa comment inserita contiene emoji personalizzate non valide. |
badRequest (400) |
invalidCommentMetadata |
I metadati della richiesta non sono validi. |
badRequest (400) |
operationNotSupported |
L'utente dell'API non è in grado di inserire un commento in risposta al commento di primo livello identificato dalla proprietà snippet.parentId . In una risorsa commentThread , la proprietà snippet.canReply indica se il visualizzatore corrente può rispondere al thread. |
badRequest (400) |
parentCommentIsPrivate |
Il commento principale specificato è privato. L'API non supporta le risposte ai commenti privati. |
badRequest (400) |
parentIdMissing |
Il commento che viene inserito deve essere collegato a un commento principale. Tuttavia, la risorsa comment nel corpo della richiesta API non ha specificato un valore per la proprietà snippet.parentId . |
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 comment nel corpo della richiesta per assicurarti che sia valida. |
forbidden (403) |
forbidden |
Impossibile creare il commento a causa di autorizzazioni insufficienti. 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) |
parentCommentNotFound |
Impossibile trovare il commento principale specificato. Controlla il valore della proprietà snippet.parentId nel corpo della richiesta per assicurarti che sia corretto. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.