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