Aggiunge un messaggio 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 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 saranno incluse nella risposta dell'API. Imposta il valore del parametro su snippet . |
Corpo della richiesta
Fornisci una risorsa liveChatMessage nel corpo della richiesta. Devi specificare i valori di queste proprietà per la risorsa
snippet.liveChatId
snippet.type
- utilizzatextMessageEvent
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. |
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 dell'API.