PlaylistImages: delete
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ลบรูปภาพของเพลย์ลิสต์
ผลกระทบจากโควต้า: การเรียกใช้วิธีการนี้มีต้นทุนโควต้า 50 หน่วย
ส่งคำขอ
คำขอ HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistImages
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
พารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ที่คำค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา
พารามิเตอร์ |
พารามิเตอร์ที่จำเป็น |
id |
string
พารามิเตอร์ id ระบุรหัสรูปภาพเพลย์ลิสต์ YouTube สำหรับรูปภาพเพลย์ลิสต์ที่กำลังลบ ในทรัพยากร playlistImages พร็อพเพอร์ตี้ id จะระบุรหัสของรูปภาพเพลย์ลิสต์ |
พารามิเตอร์ที่ไม่บังคับ |
onBehalfOfContentOwner |
string
หมายเหตุ: พารามิเตอร์ onBehalfOfContentOwner มีไว้สำหรับพาร์ทเนอร์ด้านเนื้อหาของ YouTube เท่านั้น และใช้ได้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้น
พารามิเตอร์นี้ออกแบบมาสำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จำนวนมาก ซึ่งจะช่วยให้ผู้ใช้ที่เป็นพาร์ทเนอร์กับเจ้าของเนื้อหาตรวจสอบสิทธิ์เพียงครั้งเดียว จากนั้นจะสามารถเข้าถึงและจัดการข้อมูลวิดีโอและช่องทั้งหมดของเจ้าของเนื้อหา โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับแต่ละช่อง
เมื่อมีพารามิเตอร์ ค่าของพารามิเตอร์จะระบุเจ้าของเนื้อหา และข้อมูลเข้าสู่ระบบของคำขอจะระบุผู้ใช้ YouTube ที่ได้รับมอบอำนาจให้ดำเนินการในนามของเจ้าของเนื้อหานั้น บัญชีที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหาที่ระบุในการตั้งค่าสตูดิโอ YouTube |
เนื้อหาของคำขอ
ไม่ต้องระบุเนื้อหาคำขอเมื่อเรียกใช้วิธีการนี้
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงรหัสตอบกลับ HTTP 204
(No Content
)
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-08-16 UTC
[null,null,["อัปเดตล่าสุด 2024-08-16 UTC"],[[["\u003cp\u003eThis method allows for the deletion of a playlist image using the YouTube Data API.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a playlist image requires authorization with one of the specified scopes, including \u003ccode\u003eyoutubepartner\u003c/code\u003e, \u003ccode\u003eyoutube\u003c/code\u003e, or \u003ccode\u003eyoutube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eid\u003c/code\u003e parameter is mandatory and specifies the unique ID of the playlist image to be deleted.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method has a quota cost of 50 units per request.\u003c/p\u003e\n"],["\u003cp\u003eContent partners managing multiple channels can use the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter to manage their data.\u003c/p\u003e\n"]]],["This method deletes a specific playlist image on YouTube, identified by its `id`. The request is made via a `DELETE` HTTP request to the `/playlistImages` endpoint. Authorization is required, using one of the specified scopes. A `quota cost` of 50 units is associated with each call. An optional parameter, `onBehalfOfContentOwner`, allows content partners to manage data across multiple channels. Upon successful deletion, a `204` response code is returned. No request body is needed.\n"],null,["# PlaylistImages: delete\n\nDeletes a playlist image.\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nDELETE https://www.googleapis.com/youtube/v3/playlistImages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and 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 image ID for the playlist image that is being deleted. In a `playlistImages` resource, the `id` property specifies the playlist image'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` response code (`No Content`)."]]