Gỡ bỏ lệnh cấm ngăn một người dùng cụ thể đóng góp vào cuộc trò chuyện trực tiếp, nhờ đó cho phép người dùng tham gia lại cuộc trò chuyện. Yêu cầu API phải được chủ sở hữu kênh hoặc người kiểm duyệt cuộc trò chuyện trực tiếp liên kết với lệnh cấm cho phép.
Các trường hợp sử dụng phổ biến
Yêu cầu
Yêu cầu HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
Ủy quyền
Yêu cầu này cần có sự uỷ quyền với ít nhất một trong các phạm vi sau. Để đọc thêm về tính năng xác thực và uỷ quyền, hãy xem bài viết Triển khai phương thức xác thực OAuth 2.0.
| Phạm vi |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Thông số
Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả tham số được liệt kê đều là tham số truy vấn.
| Thông số | ||
|---|---|---|
| Tham số bắt buộc | ||
id |
stringThông số id xác định lệnh cấm trò chuyện cần xoá. Giá trị xác định duy nhất cả lệnh cấm và cuộc trò chuyện. |
|
Nội dung yêu cầu
Không cung cấp nội dung yêu cầu khi gọi phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về mã trạng thái HTTP 204 No Content.
Lỗi
Bảng sau đây xác định các thông báo lỗi mà API có thể trả về để phản hồi một lệnh gọi đến phương thức này. Để biết thêm thông tin chi tiết, hãy xem thông báo lỗi.
| Loại lỗi | Chi tiết về lỗi | Nội dung mô tả |
|---|---|---|
forbidden (403) |
forbidden |
Không thể xóa lệnh cấm đã chỉ định. Lỗi này có thể xảy ra nếu yêu cầu được ủy quyền bởi một người kiểm duyệt đang cố gắng xóa lệnh cấm đối với một người kiểm duyệt khác. |
forbidden (403) |
insufficientPermissions |
Bạn không có các quyền cần thiết để xóa lệnh cấm được chỉ định. |
invalidValue (400) |
invalidLiveChatBanId |
Tham số id chỉ định một giá trị không hợp lệ. |
notFound (404) |
liveChatBanNotFound |
Không thể tìm thấy lệnh cấm đã chỉ định. |
Hãy dùng thử!
Sử dụng APIs Explorer để gọi API này cũng như xem yêu cầu và phản hồi của API.