Loại 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, từ đó 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 quan đến lệnh cấm đó uỷ quyền.
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 uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).
Phạm vi |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Tham 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.
Tham số | ||
---|---|---|
Tham số bắt buộc | ||
id |
string Thông số id xác định lệnh cấm trò chuyện cần gỡ bỏ. Giá trị này xác định duy nhất cả lệnh cấm và cuộc trò chuyện. |
Nội dung yêu cầu
Đừ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ột mã phản hồ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 lệnh gọi đến phương thức này. Vui lòng xem tài liệu về thông báo lỗi để biết thêm chi tiết.
Loại lỗi | Chi tiết lỗi | Nội dung mô tả |
---|---|---|
forbidden (403) |
forbidden |
Không thể xoá lệnh cấm đã chỉ định. Lỗi này có thể xảy ra nếu một người kiểm duyệt đang tìm cách gỡ bỏ lệnh cấm đối với một người kiểm duyệt khác cho phép gửi yêu cầu. |
forbidden (403) |
insufficientPermissions |
Bạn không có quyền cần thiết để xoá lệnh cấm đã 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ử!
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.