ลบรายการเพลย์ลิสต์
ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีค่าใช้จ่ายโควต้า 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