LiveChatBans: insert

Uniemożliwia konkretnemu użytkownikowi udział w czacie na żywo. Żądanie wywołania interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z zablokowaniem.

Typowe zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzacji znajdziesz w artykule Wdrażanie uwierzytelniania OAuth 2.0.

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

Parametry

W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametry part służą w tej operacji do dwóch celów. Określa właściwości, które zostaną ustawione przez operację zapisu, a także właściwości zwracane w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet.

Treść żądania

W treści żądania podaj zasób liveChatBan. W przypadku tego zasobu:

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

    • snippet.liveChatId
    • snippet.type
    • snippet.bannedUserDetails.channelId

  • Możesz ustawić wartości tych właściwości:

    • snippet.banDurationSeconds

Odpowiedź

Jeśli operacja się powiedzie, metoda zwróci w treści odpowiedzi zasob liveChatBan.

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 artykule Błędy interfejsu YouTube Live Streaming API.

Typ błędu Szczegóły błędu Opis
forbidden (403) insufficientPermissions Nie masz uprawnień do zablokowania użytkownikowi dostępu do określonego czatu na żywo.
forbidden (403) liveChatBanInsertionNotAllowed Nie można utworzyć określonego zakazu. Ten błąd może wystąpić, jeśli prośba ma na celu zablokowanie właściciela czatu lub innego moderatora.
invalidValue (400) invalidChannelId Nie znaleziono podanego identyfikatora kanału.
invalidValue (400) invalidLiveChatId Wartość snippet.liveChatId podana w żądaniu jest nieprawidłowa. Sprawdź powiązany zasób liveBroadcast, aby upewnić się, że masz prawidłową wartość.
notFound (404) liveChatNotFound Nie można znaleźć wskazanego czatu na żywo. Sprawdź powiązany zasób liveBroadcast, aby upewnić się, że właściwość snippet.liveChatId ma prawidłową wartość.
notFound (404) liveChatUserNotFound Nie można znaleźć użytkownika czatu na żywo, którego chcesz zablokować.
required (400) bannedUserChannelIdRequired Zasób liveChatBan przesłany w treści żądania musi zawierać wartość właściwości snippet.bannedUserDetails.channelId.
required (400) liveChatIdRequired Zasób liveChatBan przesłany w treści żądania musi zawierać wartość właściwości snippet.liveChatId.

Wypróbuj

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