PlaylistItems: delete

Xóa một mục trong danh sách phát.

Mức tác động cho hạn mức: Một lệnh gọi đến phương thức này có chi phí định mức là 50 đơ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/playlistItems

Ủy quyền

Yêu cầu này yêu cầu uỷ quyền có ít nhất một trong các phạm vi sau (đọc thêm về xác thực và cấp phép).

Phạm vi
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Các tham số

Bảng sau trình bày các tham số mà truy vấn này hỗ trợ. Tất cả thông số được liệt kê đều là thông số truy vấn.

Các tham số
Các thông số bắt buộc
id string
Tham số id chỉ định mã nhận dạng mục danh sách phát trên YouTube cho mục danh sách phát đang bị xoá. Trong tài nguyên playlistItem, thuộc tính id chỉ định mã nhận dạng của mục trong danh sách phát.
Tham số không bắt buộc
onBehalfOfContentOwner string
Lưu ý: Thông số onBehalfOfContentOwner này chỉ dành cho các đối tác nội dung trên YouTube và chỉ có thể dùng trong một yêu cầu được uỷ quyền phù hợp.

Thông số này dành cho những đối tác nội dung của YouTube sở hữu và quản lý nhiều kênh YouTube. Thông số này cho phép người dùng liên kết với chủ sở hữu nội dung xác thực một lần rồi có thể truy cập và quản lý tất cả dữ liệu video và kênh của chủ sở hữu nội dung mà không cần phải cung cấp thông tin xác thực cho từng kênh.

Khi có thông số, giá trị của thông số sẽ xác định chủ sở hữu nội dung và thông tin cấp phép của yêu cầu xác định người dùng YouTube được uỷ quyền thay mặt chủ sở hữu nội dung đó. Tài khoản mà người dùng xác thực phải được liên kết với chủ sở hữu nội dung đã chỉ định trong phần cài đặt của YouTube Studio.

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ộ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ề khi một 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 thông tin chi tiết.

Loại lỗi Thông tin chi tiết về lỗi Mô tả
forbidden (403) playlistItemsNotAccessible Yêu cầu không được phép xóa chính xác mục danh sách phát đã chỉ định.
notFound (404) playlistItemNotFound Không thể tìm thấy mục danh sách phát được xác định bằng tham số id của yêu cầu.
invalidValue (400) playlistOperationUnsupported API không hỗ trợ khả năng xoá video khỏi danh sách phát đã chỉ định. Ví dụ: bạn không thể xoá video khỏi danh sách phát video đã tải lên.

Hãy dùng thử!

Hãy 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.