ChannelSections: update

อัปเดตส่วนของช่อง

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

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

ส่งคำขอ

คำขอ HTTP

PUT 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 ที่ระบุ

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

ระบุทรัพยากร 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) idInvalid พร็อพเพอร์ตี้ id ระบุรหัสส่วนของช่องที่ไม่ถูกต้อง
invalidValue (400) idRequired พร็อพเพอร์ตี้ id ต้องระบุค่าที่ระบุส่วนของช่องที่กำลังอัปเดต
invalidValue (400) inValidPosition พร็อพเพอร์ตี้ snippet.position มีค่าไม่ถูกต้อง
invalidValue (400) maxChannelsExceeded คำขอล้มเหลวเนื่องจากพยายามรวมช่องจำนวนมากเกินไปในส่วนของช่อง
invalidValue (400) maxPlaylistExceeded คำขอล้มเหลวเนื่องจากพยายามรวมเพลย์ลิสต์จำนวนมากเกินไปในส่วนของช่อง
invalidValue (400) onePlaylistNeeded หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น singlePlaylist พร็อพเพอร์ตี้ contentDetails.playlists[] ต้องระบุเพลย์ลิสต์ 1 รายการเท่านั้น
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) channelSectionNotFound ไม่พบส่วนของช่องที่คุณพยายามอัปเดต
notFound (404) playlistNotFound ไม่พบเพลย์ลิสต์ที่ระบุไว้อย่างน้อย 1 รายการ

ลองใช้งาน

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