ChannelSections

แหล่งข้อมูล channelSection มีข้อมูลเกี่ยวกับชุดวิดีโอที่ช่องเลือกให้แสดง เช่น ส่วนอาจแสดงการอัปโหลดล่าสุดของช่อง การอัปโหลดยอดนิยม หรือวิดีโอจากเพลย์ลิสต์อย่างน้อย 1 รายการ

ช่องจะสร้างชั้นวางได้สูงสุด 10 ชั้น

วิธีการ

API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร channelSections รายการ

list
แสดงรายการทรัพยากร channelSection รายการที่ตรงกับเกณฑ์คำขอ API ลองเลย
แทรก
เพิ่มส่วนช่องไปยังช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว ช่องจะสร้างชั้นวางได้สูงสุด 10 ชั้น ลองใช้เลย
อัปเดต
อัปเดตส่วนช่อง ลองใช้เลย
ลบ
ลบส่วนช่อง ลองใช้เลย

การนำเสนอทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร channelSections

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#channelSection
etag etag
Etag ของแหล่งข้อมูลนี้
id string
รหัสที่ YouTube ใช้เพื่อระบุส่วนช่องโดยไม่ซ้ำกัน
snippet object
ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับส่วนช่อง เช่น ประเภทและชื่อ
snippet.type string
ประเภทของส่วนช่อง

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่เผยแพร่ส่วนช่องโดยไม่ซ้ำกัน
snippet.title string
ชื่อของส่วน คุณตั้งค่าได้เฉพาะชื่อของส่วนช่องที่มีค่า snippet.type เป็น multiplePlaylists หรือ multipleChannels เท่านั้น และจริงๆ แล้ว คุณต้องระบุชื่อเมื่อแทรกหรืออัปเดตส่วนประเภทดังกล่าว หากคุณระบุชื่อสำหรับส่วนช่องประเภทอื่นๆ ระบบจะไม่สนใจค่า

ค่าของพร็อพเพอร์ตี้นี้มีความยาวได้สูงสุด 100 อักขระและอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมดยกเว้น < และ >
snippet.position unsigned integer
ตำแหน่งของส่วนในหน้าช่อง พร็อพเพอร์ตี้นี้ใช้ดัชนีฐาน 0 ค่า 0 ระบุส่วนแรกที่ปรากฏในช่อง ค่า 1 จะระบุส่วนที่ 2 เป็นต้น

หากคุณไม่ระบุค่าสำหรับพร็อพเพอร์ตี้นี้เมื่อแทรกส่วนช่อง ลักษณะการทำงานเริ่มต้นคือการแสดงส่วนใหม่เป็นลำดับสุดท้าย
contentDetails object
ออบเจ็กต์ contentDetails มีรายละเอียดเกี่ยวกับเนื้อหาในส่วนช่อง เช่น รายการเพลย์ลิสต์หรือช่องที่แสดงในส่วนดังกล่าว
contentDetails.playlists[] list
รายการรหัสเพลย์ลิสต์อย่างน้อย 1 รายการที่แสดงในส่วนช่อง คุณต้องระบุรายการรหัสเพลย์ลิสต์หากพร็อพเพอร์ตี้ snippet.type ของทรัพยากร channelSection เป็น singlePlaylist หรือ multiplePlaylists และไม่ควรระบุพร็อพเพอร์ตี้นี้สำหรับส่วนประเภทอื่นๆ หากประเภทเป็น singlePlaylist รายการนี้ต้องระบุรหัสเพลย์ลิสต์ 1 รายการ
contentDetails.channels[] list
รายการรหัสช่องอย่างน้อย 1 รายการที่แสดงในส่วนช่อง คุณต้องระบุรายการรหัสแชแนลหากพร็อพเพอร์ตี้ snippet.type ของทรัพยากร channelSection คือ multipleChannels และไม่ควรระบุพร็อพเพอร์ตี้นี้สำหรับส่วนประเภทอื่นๆ คุณไม่สามารถรวมช่องของคุณเองไว้ในรายการได้