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