Chúng tôi đang cập nhật Data API để phù hợp với cách YouTube tính số lượt xem video ngắn.
Tìm hiểu thêm
PlaylistItems: delete
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Xoá một mục trong danh sách phát.
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à 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 với ít nhất một trong các phạm vi sau. Để đọc thêm về việc xác thực và uỷ quyền, hãy xem bài viết Triển khai tính năng uỷ quyền OAuth 2.0.
| Phạm vi |
|---|
https://www.googleapis.com/auth/youtubepartner |
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ả các tham số được liệt kê đều là tham số truy vấn.
| Tham số |
| Tham số bắt buộc |
id |
string
Tham số id chỉ định mã 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ã của mục trong danh sách phát. |
| Thông số tuỳ chọn |
onBehalfOfContentOwner |
string
Lưu ý: Thông số onBehalfOfContentOwner chỉ dành riêng cho các đối tác nội dung trên YouTube và chỉ có thể được sử dụng trong một yêu cầu được uỷ quyền hợp lệ.
Thông số này được thiết kế cho các đối tác nội dung trên YouTube sở hữu và quản lý nhiều kênh YouTube. Tham 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, sau đó có thể truy cập và quản lý tất cả dữ liệu kênh và video của chủ sở hữu nội dung mà không cần cung cấp thông tin xác thực cho từng kênh riêng lẻ.
Khi tham số này xuất hiện, giá trị của tham số sẽ xác định một chủ sở hữu nội dung và thông tin uỷ quyền của yêu cầu sẽ xác định một người dùng YouTube được uỷ quyền để thay mặt chủ sở hữu nội dung đó hành động. Tài khoản mà người dùng dùng để xác thực phải được liên kết với chủ sở hữu nội dung được 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ã trạng thái HTTP 204 No Content.
Lỗi
Bảng sau đây xác định 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. Để biết thêm thông tin chi tiết, hãy xem bài viết YouTube Data API – Lỗi.
| 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 uỷ quyền đúng cách để xoá mục danh sách phát đã chỉ định. |
notFound (404) |
playlistItemNotFound |
Không tìm thấy mục danh sách phát được xác định bằng thông số id của yêu cầu. |
invalidValue (400) |
playlistOperationUnsupported |
API không hỗ trợ tính năng xoá video khỏi danh sách phát đã chỉ định. Ví dụ: bạn không thể xoá một video khỏi danh sách phát video đã tải lên. |
Hãy dùng thử!
Sử dụng APIs Explorer để gọi API này và xem yêu cầu và phản hồi API.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-11-19 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-11-19 UTC."],[],[],null,["# PlaylistItems: delete\n\nDeletes a playlist item.\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nCommon use cases\n----------------\n\nThe list below shows common use cases for this method. Hover over a use case to see its description, or click on a use case to load sample parameter values in the APIs Explorer. You can open the [fullscreen APIs Explorer](#) to see code samples that dynamically update to reflect the parameter values entered in the Explorer.\n\nThe table below shows common use cases for this method. You can click on a use case name to load sample parameter values in the APIs Explorer. Or you can see code samples for a use case in the fullscreen APIs Explorer by clicking on the code icon below a use case name. In the fullscreen UI, you can update parameter and property values and the code samples will dynamically update to reflect the values you enter. \nThis method has one common use case, which is described below. The buttons below the description populate the APIs Explorer with sample values or open the fullscreen APIs Explorer to show code samples that use those values. The code samples also dynamically update if you change the values.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nDELETE https://www.googleapis.com/youtube/v3/playlistItems\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 authorization](/youtube/v3/guides/authentication).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `id` | `string` The **id** parameter specifies the YouTube playlist item ID for the playlist item that is being deleted. In a `playlistItem` resource, the `id` property specifies the playlist item's ID. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** The **onBehalfOfContentOwner** parameter is intended exclusively for YouTube content partners and can only be used in a properly [authorized request](/youtube/v3/guides/authentication). This parameter is designed for YouTube content partners that own and manage many different YouTube channels. It enables users affiliated with the content owner to authenticate once and then be able to access and manage all of the content owner's video and channel data, without having to provide authentication credentials for each individual channel. When the parameter is present, its value identifies a content owner, and the request's authorization credentials identify a YouTube user who is authorized to act on behalf of that content owner. The account that the user authenticates with must be [linked to the specified content owner](https://support.google.com/youtube/answer/4524878) in the YouTube Creator Studio settings. |\n\n### Request body\n\nDo not provide a request body when calling this method.\n\nResponse\n--------\n\nIf successful, this method returns an HTTP `204 No Content` status code.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Data API - Errors](/youtube/v3/docs/errors).\n\n| Error type | Error detail | Description |\n|----------------------|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `forbidden (403)` | `playlistItemsNotAccessible` | The request is not properly authorized to delete the specified playlist item. |\n| `notFound (404)` | `playlistItemNotFound` | The playlist item identified with the request's `id` parameter cannot be found. |\n| `invalidValue (400)` | `playlistOperationUnsupported` | The API does not support the ability to delete videos from the specified playlist. For example, you can't delete a video from your uploaded videos playlist. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
