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 และไม่ควรระบุพร็อพเพอร์ตี้นี้สำหรับส่วนประเภทอื่นๆ คุณไม่สามารถรวมช่องของคุณเองไว้ในรายการได้