Xoá một tin nhắn 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 của Trò chuyện trong sự kiện phát trực tiếp liên kết với lệnh cấm cấp quyền.
Tác động đến hạn mức: Một lệnh gọi đến phương thức này có chi phí hạn mức là 20 đơn vị.
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/messages
Ủy quyền
Yêu cầu này cần được cấp 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à cấp quyền).
| 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ả các tham số được liệt kê đều là tham số truy vấn.
| Thông số | ||
|---|---|---|
| Tham số bắt buộc | ||
id |
stringTham số id chỉ định mã nhận dạng tin nhắn trong cuộc trò chuyện trên YouTube của tài nguyên đang bị xoá. |
|
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ã 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. Hãy xem tài liệu về thông báo lỗi để biết thêm thông tin.
| Loại lỗi | Chi tiết lỗi | Mô tả |
|---|---|---|
forbidden (403) |
forbidden |
Bạn không có các quyền cần thiết để xoá tin nhắn đã chỉ định. |
forbidden (403) |
modificationNotAllowed |
Không thể xoá tài nguyên liveChatMessage đã chỉ định. Tham số id có thể xác định một tin nhắn do người kiểm duyệt hoặc người dùng khác tạo mà bạn không thể xoá. |
notFound (404) |
liveChatMessageNotFound |
Không tìm thấy tin nhắn mà bạn đang cố gắng xoá. Hãy kiểm tra giá trị của tham số id để đảm bảo giá trị đó chính xác. |
Hãy dùng thử!
Sử dụng APIs Explorer để gọi API này và xem Yêu cầu API và phản hồi của API.