CommentThreads: insert

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

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.
  • Se il commento si applica a un canale, assicurati che la risorsa specificata nel corpo della richiesta fornisca un valore per la proprietà snippet.channelId. Un commento applicabile a un canale viene visualizzato nella scheda Discussione del canale.
  • Se il commento si applica a un video, assicurati che la risorsa specifichi dei valori per entrambe le proprietà snippet.channelId e snippet.videoId. Un commento valido per un video viene mostrato nella relativa pagina di visualizzazione.
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.