ลบรายการในเพลย์ลิสต์
ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีต้นทุนโควต้า 50 หน่วย
กรณีการใช้งานทั่วไป
ส่งคำขอ
คำขอ HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistItems
การให้สิทธิ์
คำขอนี้ต้องมีการให้สิทธิ์ด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์ได้ที่การใช้การให้สิทธิ์ OAuth 2.0
| ขอบเขต |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
พารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา
| พารามิเตอร์ | ||
|---|---|---|
| พารามิเตอร์ที่จำเป็น | ||
id |
stringพารามิเตอร์ id จะระบุรหัสรายการเพลย์ลิสต์ YouTube สำหรับรายการเพลย์ลิสต์ที่จะลบ ในทรัพยากร playlistItem พร็อพเพอร์ตี้ id จะระบุรหัสของรายการเพลย์ลิสต์ |
|
| พารามิเตอร์ที่ไม่บังคับ | ||
onBehalfOfContentOwner |
stringหมายเหตุ: พารามิเตอร์ onBehalfOfContentOwner มีไว้สำหรับพาร์ทเนอร์เนื้อหา YouTube โดยเฉพาะ และใช้ได้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้นพารามิเตอร์นี้ออกแบบมาสำหรับพาร์ทเนอร์เนื้อหา YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube หลายช่อง ซึ่งจะช่วยให้ผู้ใช้ที่เชื่อมโยงกับเจ้าของเนื้อหาสามารถตรวจสอบสิทธิ์เพียงครั้งเดียว จากนั้นจะสามารถเข้าถึงและจัดการข้อมูลวิดีโอและช่องทั้งหมดของเจ้าของเนื้อหาได้โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับแต่ละช่อง เมื่อมีพารามิเตอร์นี้ ค่าของพารามิเตอร์จะระบุเจ้าของเนื้อหา และข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอจะระบุผู้ใช้ YouTube ที่ได้รับอนุญาตให้ดำเนินการในนามของเจ้าของเนื้อหารายนั้น บัญชีที่ผู้ใช้ใช้ตรวจสอบสิทธิ์ต้องลิงก์กับเจ้าของเนื้อหาที่ระบุในการตั้งค่า YouTube Creator Studio |
|
เนื้อหาของคำขอ
อย่าระบุเนื้อหาคำขอเมื่อเรียกใช้เมธอดนี้
คำตอบ
หากสําเร็จ วิธีการนี้จะแสดงรหัสสถานะ HTTP 204 No Content
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงเมื่อมีการเรียกใช้เมธอดนี้ ดูรายละเอียดเพิ่มเติมได้ที่ YouTube Data API - ข้อผิดพลาด
| ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
คำขอไม่ได้รับอนุญาตอย่างถูกต้องให้ลบรายการเพลย์ลิสต์ที่ระบุ |
notFound (404) |
playlistItemNotFound |
ไม่พบรายการเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการลบวิดีโอออกจากเพลย์ลิสต์ที่ระบุ เช่น คุณจะลบวิดีโอออกจากเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้ |
ลองใช้งาน
ใช้ APIs Explorer เพื่อเรียก API นี้และดูคําขอและการตอบกลับของ API