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