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

LiveChatMessages: insert

Dodaje wiadomość do czatu na żywo.

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego 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

W tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
`part`	`string` Parametr `part` służy 2 celom. Wskazuje on właściwości, które ustawi operacja zapisu, oraz właściwości, które zawiera odpowiedź interfejsu API. Ustaw wartość parametru na `snippet`.

Treść żądania

Podaj zasób LiveChatMessage w treści żądania. Dla tego zasobu musisz podać wartości tych właściwości

snippet.liveChatId
snippet.type – użyj textMessageEvent
snippet.textMessageDetails.messageText

Odpowiedź

Jeśli operacja się uda, ta metoda 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu	Szczegóły błędu	Opis
`forbidden (403)`	`forbidden`	Nie masz uprawnień do utworzenia określonej wiadomości.
`forbidden (403)`	`liveChatDisabled`	Wybrany czat na żywo został wyłączony przez właściciela, co oznacza, że nie można do niego dodawać wiadomości.
`forbidden (403)`	`liveChatEnded`	Wybrany 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 określony 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 oraz odpowiedź interfejsu API.