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 (scopri di più su autenticazione e autorizzazione).

Ambito
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametri

La seguente tabella 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, nonché le proprietà che saranno incluse nella risposta dell'API. Imposta il valore del parametro su snippet.

Corpo della richiesta

Fornisci una risorsa liveChatMessage nel corpo della richiesta. Per la risorsa, devi specificare i valori relativi a 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 articoli 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 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 dell'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, il che significa che non è possibile aggiungere messaggi alla chat.
forbidden (403) liveChatEnded La chat live specificata non è più in diretta.
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 fissato.
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 API.