PlaylistItems: insert

เพิ่มทรัพยากรลงในเพลย์ลิสต์

ผลกระทบจากโควต้า: การเรียกใช้วิธีการนี้มีต้นทุนโควต้า 50 หน่วย

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ HTTP

POST 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

พารามิเตอร์

ตารางต่อไปนี้จะแสดงพารามิเตอร์ที่คําค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จําเป็น
part	string พารามิเตอร์ part มีจุดประสงค์ 2 ประการในการดําเนินการนี้ ค่านี้ระบุพร็อพเพอร์ตี้ที่การตั้งค่าการเขียนจะ รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับ API จะรวมอยู่ด้วย รายการต่อไปนี้มีชื่อ part ที่คุณใส่ไว้ในค่าพารามิเตอร์ได้ contentDetails id snippet status
พารามิเตอร์ที่ไม่บังคับ
onBehalfOfContentOwner	string พารามิเตอร์นี้ใช้ได้เฉพาะในคําขอที่ได้รับอนุญาตอย่างถูกต้อง หมายเหตุ: พารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น พารามิเตอร์ onBehalfOfContentOwner ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุผู้ใช้ CMS ของ YouTube ที่ทําหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหา YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จํานวนมาก ช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์ได้เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบของแต่ละช่อง บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์ด้วยจะต้องลิงก์กับเจ้าของเนื้อหาของ YouTube ที่ระบุ

เนื้อหาของคำขอ

ระบุแหล่งข้อมูลเพลย์ลิสต์ในส่วนเนื้อหาคําขอ สําหรับทรัพยากรดังกล่าว ให้ทําดังนี้

• คุณต้องระบุค่าสําหรับพร็อพเพอร์ตี้เหล่านี้

  • snippet.playlistId
  • snippet.resourceId

• คุณตั้งค่าพร็อพเพอร์ตี้เหล่านี้ได้

  • snippet.playlistId
  • snippet.position
  • snippet.resourceId
  • contentDetails.note
  • contentDetails.startAt
  • contentDetails.endAt

คำตอบ

หากใช้วิธีนี้ วิธีนี้จะแสดงทรัพยากรเป็นเพลย์ลิสต์ในส่วนเนื้อหาของการตอบกลับ

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	playlistContainsMaximumNumberOfVideos	เพลย์ลิสต์มีรายการถึงจํานวนสูงสุดที่อนุญาตแล้ว
forbidden (403)	playlistItemsNotAccessible	คําขอไม่ได้รับอนุญาตอย่างถูกต้องให้แทรกรายการเพลย์ลิสต์ที่ระบุ
invalidValue (400)	invalidContentDetails	พร็อพเพอร์ตี้ contentDetails ในคําขอไม่ถูกต้อง สาเหตุที่เป็นไปได้คือช่อง contentDetails.note ยาวเกิน 280 อักขระ
invalidValue (400)	invalidPlaylistItemPosition	คําขอพยายามกําหนดตําแหน่งของรายการเพลย์ลิสต์เป็นค่าที่ไม่ถูกต้องหรือไม่รองรับ ตรวจสอบค่าของพร็อพเพอร์ตี้ position ใน snippet ของทรัพยากร
invalidValue (400)	invalidResourceType	การดําเนินการนี้ไม่รองรับ type ที่ระบุสําหรับรหัสทรัพยากร รหัสทรัพยากรจะระบุรายการที่กําลังเพิ่มลงในเพลย์ลิสต์ เช่น youtube#video
invalidValue (400)	manualSortRequired	คําขอพยายามกําหนดตําแหน่งของรายการเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง (ตัวอย่างเช่น รายการเพลย์ลิสต์อาจจัดเรียงตามวันที่หรือความนิยม) คุณแก้ไขข้อผิดพลาดได้โดยการนําองค์ประกอบ snippet.position ออกจากทรัพยากรที่คําขอแทรก หากต้องการให้รายการเพลย์ลิสต์มีตําแหน่งที่เฉพาะเจาะจงในรายการ คุณต้องอัปเดตตัวเลือกการจัดลําดับของเพลย์ลิสต์เป็นด้วยตนเองในการตั้งค่าของเพลย์ลิสต์ก่อน คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอ YouTube
invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	วิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในเพลย์ลิสต์ซีรีส์อื่นแล้ว
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ playlistId ของคําขอ
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์ ตรวจสอบค่าของพร็อพเพอร์ตี้ videoId ว่าถูกต้องแล้ว
required (400)	channelIdRequired	คําขอไม่ได้ระบุค่าสําหรับพร็อพเพอร์ตี้ channelId ที่จําเป็น
required (400)	playlistIdRequired	คําขอไม่ได้ระบุค่าสําหรับพร็อพเพอร์ตี้ playlistId ที่จําเป็น
required (400)	resourceIdRequired	คําขอต้องมีทรัพยากรที่ออบเจ็กต์ snippet ระบุ resourceId
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับความสามารถในการแทรกวิดีโอลงในเพลย์ลิสต์ที่ระบุ เช่น คุณไม่สามารถแทรกวิดีโอลงในเพลย์ลิสต์วิดีโอที่อัปโหลด

ลองใช้เลย

ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคําขอและการตอบกลับ API