LiveChatMessages: insert

Dodaje wiadomość lub ankietę do czatu na żywo.

Typowe zastosowania

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzacji znajdziesz w artykule Wdrażanie uwierzytelniania OAuth 2.0.

Zakres
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametry

W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part służy do 2 celów. Określa właściwości, które zostaną ustawione przez operację zapisu, a także właściwości, które będą uwzględnione w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet.

Treść żądania

W treści żądania podaj zasób liveChatMessage. W przypadku tego zasobu musisz podać wartości tych właściwości

  • snippet.liveChatId
  • snippet.type – wybierz jedną z tych opcji: textMessageEvent lub pollEvent
  • Jeśli typ to textMessageEvent, dodaj snippet.textMessageDetails.messageText
  • Jeśli typ to pollEvent, podaj wartość snippet.pollDetails z tymi wartościami:
    • snippet.pollDetails.metadata.options.questionText
    • Lista snippet.pollDetails.metadata.options.optionText. Musisz podać co najmniej 2 i nie więcej niż 5 elementów. Elementy są wyświetlane w kolejności, w której się znajdują.

Odpowiedź

Jeśli operacja się powiedzie, zwróci w treści odpowiedzi zasób liveChatMessage.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w artykule Błędy interfejsu YouTube Live Streaming API.

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie masz uprawnień wymaganych do utworzenia określonej wiadomości.
forbidden (403) liveChatDisabled Właściciel wyłączył określony czat na żywo, co oznacza, że nie można dodawać do niego wiadomości.
forbidden (403) liveChatEnded Wskazany czat na żywo nie jest już aktywny.
invalidValue (400) messageTextInvalid Tekst wiadomości (snippet.textMessageDetails.messageText) jest nieprawidłowy.
notFound (404) liveChatNotFound Czat na żywo wskazany w żądaniu interfejsu API nie istnieje. Ten błąd występuje, gdy czat został usunięty przez właściciela.
required (400) liveChatIdRequired Zasób liveChatMessage musi zawierać i określać wartość właściwości snippet.liveChatId.
required (400) messageTextRequired Zasób liveChatMessage musi zawierać i określać wartość właściwości snippet.textMessageDetails.messageText.
required (400) typeRequired Zasób liveChatMessage musi zawierać i określać wartość właściwości snippet.type. Ustaw wartość parametru na text
required (400) preconditionCheckFailed Zaznaczona aktywna ankieta już istnieje.
rateLimitExceeded rateLimitExceeded Użytkownik opublikował zbyt wiele wiadomości czatu w danym przedziale czasu.

Wypróbuj

Użyj adresu APIs Explorer, aby wywołać ten interfejs API i zobaczyć żądanie oraz odpowiedź interfejsu API.