Comments: insert

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:
  • id
  • snippet

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.