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