LiveChatMessages: insert

Dodaje wiadomość do czatu na żywo. Obecnie interfejs API obsługuje tylko wstawianie SMS-ów.

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. W przypadku tego zasobu:

  • Musisz podać wartość tych właściwości:

    • snippet.liveChatId
    • snippet.type: obecnie jedyną obsługiwaną wartością jest 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.
rateLimitExceeded rateLimitExceeded Użytkownik opublikował zbyt wiele wiadomości na czacie w danym okresie.
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

Wypróbuj

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