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żyjtextMessageEvent
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.