Aggiunge un messaggio a una chat live. L'API supporta attualmente la possibilità di inserire solo messaggi di testo.
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 tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
| Parametri | ||
|---|---|---|
| Parametri obbligatori | ||
part |
stringIl parametro part ha due scopi. Identifica le proprietà che verranno impostate dall'operazione di scrittura e quelle 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 questa risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.liveChatIdsnippet.type: attualmente l'unico valore supportato ètextMessageEvent.snippet.textMessageDetails.messageText
Risposta
Se l'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 errore | Descrizione |
|---|---|---|
forbidden (403) |
forbidden |
Non hai le autorizzazioni necessarie per creare il messaggio specificato. |
forbidden (403) |
liveChatDisabled |
La chat live specificata è stata disattivata dal proprietario, quindi non è possibile aggiungere messaggi alla chat. |
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. |
rateLimitExceeded |
rateLimitExceeded |
L'utente ha pubblicato troppi messaggi di chat in un determinato periodo di tempo. |
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 |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.