Usuwa blokadę, która uniemożliwia konkretnemu użytkownikowi udział w czacie na żywo, dzięki czemu może on ponownie dołączyć do czatu. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z blokadą.
Typowe przypadki użycia
Żądanie
Żądanie HTTP
DELETE 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 Implementowanie 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 | ||
|---|---|---|
| Wymagane parametry | ||
id |
stringParametr id identyfikuje blokadę na czacie, którą chcesz usunąć. Wartość jednoznacznie identyfikuje blokadę i czat. |
|
Treść żądania
Podczas wywoływania tej metody nie podawaj treści żądania.
Odpowiedź
Jeśli operacja się powiedzie, ta metoda zwraca kod stanu HTTP 204 No Content.
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 komunikacie o błędzie.
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Nie można usunąć określonej blokady. Ten błąd może wystąpić, jeśli żądanie jest autoryzowane przez moderatora, który próbuje usunąć blokadę nałożoną przez innego moderatora. |
forbidden (403) |
insufficientPermissions |
Nie masz uprawnień do usunięcia określonej blokady. |
invalidValue (400) |
invalidLiveChatBanId |
Parametr id ma nieprawidłową wartość. |
notFound (404) |
liveChatBanNotFound |
Nie można znaleźć określonej blokady. |
Wypróbuj
Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.