Powoduje usunięcie blokady, która uniemożliwia konkretnemu użytkownikowi współtworzenie czatu na żywo i pozwala mu 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
Prośba
Żądanie HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
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 | ||
id |
stringParametr id wskazuje blokadę na czacie, którą chcesz usunąć. Wartość jednoznacznie identyfikuje blokadę i czat. |
|
Treść żądania
Nie podawaj treści żądania podczas wywoływania tej metody.
Odpowiedź
Jeśli operacja się uda, metoda zwróci kod odpowiedzi 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.
| 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 zostało autoryzowane przez jednego moderatora, który próbuje cofnąć zablokowanie innego moderatora. |
forbidden (403) |
insufficientPermissions |
Nie masz odpowiednich uprawnień, aby usunąć określony zakaz. |
invalidValue (400) |
invalidLiveChatBanId |
Parametr id zawiera nieprawidłową wartość. |
notFound (404) |
liveChatBanNotFound |
Nie udało się znaleźć podanego zakazu. |
Wypróbuj
Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.