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