Ta strona została przetłumaczona przez Cloud Translation API.

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.