ChannelSections: insert

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

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

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

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/youtube/v3/channelSections

การให้สิทธิ์

คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตอย่างน้อย 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
พารามิเตอร์ที่ไม่บังคับ
onBehalfOfContentOwner string
พารามิเตอร์นี้ใช้ได้เฉพาะในคำขอที่ได้รับอนุญาตอย่างถูกต้อง หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น

พารามิเตอร์ onBehalfOfContentOwner บ่งชี้ว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube หลายช่อง ซึ่งช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์ได้เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้โดยไม่ต้องระบุข้อมูลรับรองการตรวจสอบสิทธิ์สำหรับแต่ละช่อง บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์ต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ
onBehalfOfContentOwnerChannel string
พารามิเตอร์นี้ใช้ได้เฉพาะในคำขอที่ได้รับอนุญาตอย่างถูกต้อง หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น

พารามิเตอร์ onBehalfOfContentOwnerChannel จะระบุรหัสช่อง YouTube ของช่องที่จะเพิ่มวิดีโอ พารามิเตอร์นี้จำเป็นเมื่อคำขอระบุค่าสำหรับพารามิเตอร์ onBehalfOfContentOwner และใช้ได้เฉพาะกับพารามิเตอร์ดังกล่าวเท่านั้น นอกจากนี้ คำขอต้องได้รับอนุญาตโดยใช้บัญชี CMS ที่ลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์ onBehalfOfContentOwner ระบุ สุดท้าย ช่องที่ค่าพารามิเตอร์ onBehalfOfContentOwnerChannel ระบุต้องลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์ onBehalfOfContentOwner ระบุ

พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube หลายช่อง ซึ่งช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์ได้เพียงครั้งเดียวและดำเนินการในนามของช่องที่ระบุในค่าพารามิเตอร์ได้โดยไม่ต้องระบุข้อมูลรับรองการตรวจสอบสิทธิ์สำหรับแต่ละช่อง

เนื้อความของคำขอ

ระบุทรัพยากร channelSection ในเนื้อความของคำขอ สำหรับทรัพยากรดังกล่าว ให้ทำดังนี้

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

    • snippet.type

  • คุณสามารถตั้งค่าสำหรับพร็อพเพอร์ตี้ต่อไปนี้

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

คำตอบ

หากทำสำเร็จ เมธอดนี้จะแสดงผลทรัพยากร channelSection ในเนื้อหาการตอบกลับ

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) notEditable สร้างส่วนของช่องนี้ไม่ได้
badRequest (400) typeRequired ทรัพยากร channelSection ต้องระบุค่าสำหรับฟิลด์ snippet.type
forbidden (403) channelSectionForbidden คำขอไม่ผ่านการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่ได้รับการรองรับสำหรับช่องนี้
invalidValue (400) channelNotActive ช่องที่ระบุไว้อย่างน้อย 1 ช่องไม่ใช้งาน
invalidValue (400) channelsDuplicated คำขอล้มเหลวเนื่องจากระบุช่องที่ซ้ำกัน
invalidValue (400) channelsNeeded หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น multipleChannels คุณต้องระบุพร็อพเพอร์ตี้ contentDetails.channels[] และต้องระบุช่องอย่างน้อย 1 ช่อง
invalidValue (400) channelsNotExpected ทรัพยากรที่ระบุไว้ในคำขอระบุค่าสำหรับพร็อพเพอร์ตี้ contentDetails.channels[] แต่ระบบไม่คาดหวังให้มีช่องสำหรับส่วนของช่องประเภทนี้
invalidValue (400) contentDetailsNeeded ทรัพยากรที่คุณกำลังแทรกต้องมีออบเจ็กต์ contentDetails สำหรับส่วนของช่องประเภทนี้
invalidValue (400) inValidPosition พร็อพเพอร์ตี้ snippet.position มีค่าที่ไม่ถูกต้อง
invalidValue (400) maxChannelSectionExceeded คำขอไม่สามารถดำเนินการให้เสร็จสมบูรณ์ได้เนื่องจากช่องมีส่วนของช่องครบจำนวนสูงสุดแล้ว
invalidValue (400) maxChannelsExceeded คำขอล้มเหลวเนื่องจากพยายามรวมช่องหลายช่องเกินไปในส่วนของช่อง
invalidValue (400) maxPlaylistExceeded คำขอล้มเหลวเนื่องจากพยายามรวมเพลย์ลิสต์หลายรายการเกินไปในส่วนของช่อง
invalidValue (400) onePlaylistNeeded หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น singlePlaylist คุณต้องระบุเพลย์ลิสต์ 1 รายการในพร็อพเพอร์ตี้ contentDetails.playlists[]
invalidValue (400) ownChannelInChannels คุณไม่สามารถรวมช่องของตัวเองไว้ในส่วนของช่องที่ปรากฏในช่องนั้น
invalidValue (400) playlistIsPrivate เพลย์ลิสต์ที่ระบุไว้อย่างน้อย 1 รายการเป็นแบบส่วนตัว จึงรวมไว้ในส่วนของช่องไม่ได้
invalidValue (400) playlistsDuplicated คำขอล้มเหลวเนื่องจากระบุเพลย์ลิสต์ที่ซ้ำกัน
invalidValue (400) playlistsNeeded หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น singlePlaylist หรือ multiplePlaylists คุณต้องระบุพร็อพเพอร์ตี้ contentDetails.playlists[]
invalidValue (400) playlistsNotExpected ทรัพยากรที่ระบุไว้ในคำขอระบุค่าสำหรับพร็อพเพอร์ตี้ contentDetails.playlists[] แต่ระบบไม่คาดหวังให้มีเพลย์ลิสต์สำหรับส่วนของช่องประเภทนี้
invalidValue (400) snippetNeeded คุณต้องระบุ snippet เพื่อสร้างส่วนของช่อง
invalidValue (400) titleLengthExceeded ค่าของพร็อพเพอร์ตี้ snippet.title ยาวเกินไป
invalidValue (400) titleRequired หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น multiplePlaylists หรือ multipleChannels คุณต้องตั้งชื่อส่วนโดยระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.title
notFound (404) channelNotFound ไม่พบช่องที่ระบุไว้อย่างน้อย 1 ช่อง
notFound (404) playlistNotFound ไม่พบเพลย์ลิสต์ที่ระบุไว้อย่างน้อย 1 รายการ

ลองใช้งาน

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