LiveChatMessages: insert

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.