LiveChatMessages: insert

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

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji przy użyciu co najmniej 1 z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

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

Parametry

Tabela poniżej zawiera 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 dwóch celów. Określa on właściwości, które ustawi operacja zapisu, a także właściwości zawarte w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet.

Treść żądania

Podaj zasób LiveChatMessage w treści żądania. W przypadku tego zasobu musisz określić wartości tych właściwości

  • snippet.liveChatId
  • snippet.type – wybierz jedną z tych opcji: textMessageEvent lub pollEvent
  • Jeśli typ to textMessageEvent, uwzględnij snippet.textMessageDetails.messageText
  • Jeśli typ to pollEvent, uwzględnij snippet.pollDetails z tymi wartościami:
    • snippet.pollDetails.metadata.options.questionText
    • Lista: snippet.pollDetails.metadata.options.optionText. Lista musi zawierać od dwóch do pięciu elementów. Produkty są wyświetlane po kolei w takiej kolejności, w jakiej zostały wymienione.

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób LiveChatMessage w treści odpowiedzi.

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 dokumentacji komunikatu o błędzie.

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie masz uprawnień wymaganych do utworzenia określonej wiadomości.
forbidden (403) liveChatDisabled Podany czat na żywo został wyłączony przez właściciela, co oznacza, że nie można dodawać wiadomości do czatu.
forbidden (403) liveChatEnded Podany 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 do interfejsu API nie istnieje. Ten błąd występuje, jeśli 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 Przypięta aktywna ankieta już istnieje.
rateLimitExceeded rateLimitExceeded Użytkownik opublikował zbyt wiele wiadomości na czacie w danym okresie.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie i odpowiedź interfejsu API.