LiveChatMessages: insert

Aggiunge un messaggio o un sondaggio a una chat live.

Casi d'uso comuni

Richiesta

Richiesta HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti. Per saperne di più sull'autenticazione e sull'autorizzazione, consulta Implementazione dell'autenticazione OAuth 2.0.

Ambito
https://www.googleapis.com/auth/youtube
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 ha due scopi. Identifica le proprietà che verranno impostate dall'operazione di scrittura e quelle che verranno incluse nella risposta dell'API. Imposta il valore del parametro su snippet.

Corpo della richiesta

Fornisci una risorsa liveChatMessage nel corpo della richiesta. Per questa risorsa, devi specificare i valori per queste proprietà

  • snippet.liveChatId
  • snippet.type: scegli una delle seguenti opzioni: textMessageEvent o pollEvent
  • Se il tipo è textMessageEvent, includi snippet.textMessageDetails.messageText
  • Se il tipo è pollEvent, includi snippet.pollDetails con i seguenti valori:
    • snippet.pollDetails.metadata.options.questionText
    • Elenco di snippet.pollDetails.metadata.options.optionText. Devi elencare almeno due elementi e non più di cinque. Gli elementi vengono visualizzati in sequenza nell'ordine in cui sono elencati.

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa liveChatMessage nel corpo della risposta.

Errori

La seguente tabella identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta la pagina API YouTube Live Streaming - Errori.

Tipo di errore Dettagli errore Descrizione
forbidden (403) forbidden Non disponi delle autorizzazioni necessarie per creare il messaggio specificato.
forbidden (403) liveChatDisabled La chat live specificata è stata disattivata dal proprietario, pertanto non è possibile aggiungere messaggi.
forbidden (403) liveChatEnded La chat live specificata non è più attiva.
invalidValue (400) messageTextInvalid Il testo del messaggio (snippet.textMessageDetails.messageText) non è valido.
notFound (404) liveChatNotFound La chat live identificata nella richiesta API non esiste. Questo errore si verifica se la chat è stata eliminata dal proprietario.
required (400) liveChatIdRequired La risorsa liveChatMessage deve includere e specificare un valore per la proprietà snippet.liveChatId.
required (400) messageTextRequired La risorsa liveChatMessage deve includere e specificare un valore per la proprietà snippet.textMessageDetails.messageText.
required (400) typeRequired La risorsa liveChatMessage deve includere e specificare un valore per la proprietà snippet.type. Imposta il valore del parametro su text
required (400) preconditionCheckFailed Esiste già un sondaggio attivo bloccato.
rateLimitExceeded rateLimitExceeded L'utente ha pubblicato troppi messaggi di chat in un determinato periodo di tempo.

Prova

Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.