ลบรายการเพลย์ลิสต์
ผลกระทบของโควต้า: การเรียกใช้วิธีการนี้มีค่าใช้จ่ายโควต้า 50 หน่วย
Use Case ทั่วไป
ส่งคำขอ
คำขอ 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 หลายช่อง ซึ่งจะช่วยให้ผู้ใช้ที่เป็นพาร์ทเนอร์กับเจ้าของเนื้อหาสามารถตรวจสอบสิทธิ์เพียงครั้งเดียว จากนั้นจะเข้าถึงและจัดการข้อมูลวิดีโอและช่องทั้งหมดของเจ้าของเนื้อหาได้โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับแต่ละช่อง เมื่อมีพารามิเตอร์อยู่ ค่าของพารามิเตอร์จะระบุเจ้าของเนื้อหา และข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอจะระบุผู้ใช้ YouTube ที่ได้รับอนุญาตให้ดำเนินการในนามของเจ้าของเนื้อหารายนั้น บัญชีที่ผู้ใช้ตรวจสอบสิทธิ์ต้องลิงก์กับเจ้าของเนื้อหาที่ระบุในการตั้งค่า YouTube Creator Studio |
เนื้อหาของคำขอ
ไม่ต้องระบุเนื้อหาคำขอเมื่อเรียกใช้วิธีการนี้
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงโค้ดตอบกลับ HTTP 204
(No Content
)
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด
ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
คำขอไม่ได้รับอนุญาตให้ลบรายการเพลย์ลิสต์ที่ระบุอย่างถูกต้อง |
notFound (404) |
playlistItemNotFound |
ไม่พบรายการเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการลบวิดีโอออกจากเพลย์ลิสต์ที่ระบุ เช่น คุณจะลบวิดีโอออกจากเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้ |
ลองใช้เลย
ใช้ APIs Explorer เพื่อเรียกใช้ API นี้เพื่อดูคำขอและการตอบสนองของ API