LiveChatMessages: insert

Aggiunge un messaggio o un sondaggio a una chat live.

Impatto sulla quota: una chiamata a questo metodo ha un costo di quota di 20 unità.

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. Per saperne di più sull'autenticazione e sull'autorizzazione, consulta Implementare l'autenticazione OAuth 2.0.

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 l'operazione di scrittura imposterà, nonché le proprietà che la risposta dell'API includerà. Imposta il valore del parametro su snippet.

Corpo della richiesta

Fornisci una risorsa liveChatMessage nel corpo della richiesta. Per questa risorsa, devi specificare i valori per 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 l'oggetto snippet.pollDetails strutturato come segue:
    • snippet.pollDetails.metadata.questionText (stringa): la domanda principale del sondaggio.
    • snippet.pollDetails.metadata.options (array): un elenco di oggetti di opzione.
    • Requisiti: devi includere un minimo di 2 e un massimo di 4 elementi.
    • Ordine: gli elementi vengono visualizzati in sequenza nell'ordine esatto in cui sono elencati.
    • Ogni oggetto dell'array deve contenere:
      • optionText (stringa): il testo visualizzato per la scelta specifica del sondaggio.

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 API YouTube Live Streaming - Errori.

Tipo di errore Dettagli 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 parametro su text
required (400) preconditionCheckFailed Esiste già un sondaggio attivo bloccato.
rateLimitExceeded rateLimitExceeded L'utente ha pubblicato troppi messaggi chat in un determinato periodo di tempo.

Prova

Utilizza APIs Explorer per chiamare questa API e visualizzare la richiesta API e la risposta.