Aggiunge un messaggio a una chat dal vivo. L'API attualmente supporta la possibilità di inserire solo SMS.
Casi d'uso comuni
Risorse richieste:
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
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 ha due scopi. Identifica le proprietà impostate dall'operazione di scrittura e le proprietà 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 la risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.liveChatId
snippet.type
: al momento, l'unico valore supportato ètextMessageEvent
.snippet.textMessageDetails.messageText
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 maggiori dettagli, consulta la documentazione sui 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 dal vivo specificata è stata disattivata dal proprietario e, di conseguenza, i messaggi non possono essere aggiunti alla chat. |
forbidden (403) |
liveChatEnded |
La chat dal vivo specificata non è più dal vivo. |
invalidValue (400) |
messageTextInvalid |
Il testo del messaggio (snippet.textMessageDetails.messageText ) non è valido. |
notFound (404) |
liveChatNotFound |
La chat dal vivo 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.