ChannelSections: list

แสดงผลรายการทรัพยากร channelSection ที่ตรงกับเกณฑ์คำขอ API

ผลกระทบต่อโควต้า: การเรียกเมธอดนี้มีค่าใช้จ่ายโควต้า 1 หน่วย

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/youtube/v3/channelSections

พารามิเตอร์

ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงเป็นพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part string
พารามิเตอร์ part ระบุรายการพร็อพเพอร์ตี้ทรัพยากร channelSection อย่างน้อย 1 รายการที่คั่นด้วยคอมมา ซึ่งการตอบกลับจาก API จะรวมไว้

หากพารามิเตอร์ระบุพร็อพเพอร์ตี้ที่มีพร็อพเพอร์ตี้ย่อย ระบบจะรวมพร็อพเพอร์ตี้ย่อยไว้ในการตอบกลับ เช่น ในทรัพยากร channelSection พร็อพเพอร์ตี้ snippet มีพร็อพเพอร์ตี้อื่นๆ เช่น ชื่อที่แสดงสำหรับส่วน หากคุณตั้งค่า part=snippet การตอบกลับจาก API จะมีพร็อพเพอร์ตี้ที่ซ้อนกันทั้งหมดด้วย

รายการต่อไปนี้มีชื่อ part ที่คุณสามารถรวมไว้ในค่าพารามิเตอร์
  • contentDetails
  • id
  • snippet
ตัวกรอง (ระบุพารามิเตอร์ต่อไปนี้เพียง 1 รายการ)
channelId string
พารามิเตอร์ channelId ระบุรหัสช่อง YouTube หากคำขอระบุค่าสำหรับพารามิเตอร์นี้ API จะแสดงผลเฉพาะส่วนของช่องที่ระบุ
id string
พารามิเตอร์ id ระบุรายการที่คั่นด้วยคอมมาของรหัส ซึ่งระบุทรัพยากร channelSection ที่กำลังดึงข้อมูลอย่างไม่ซ้ำกัน ในทรัพยากร channelSection พร็อพเพอร์ตี้ id จะระบุรหัสของส่วน
mine boolean
พารามิเตอร์นี้ใช้ได้เฉพาะในคำขอที่ได้รับอนุญาตอย่างถูกต้อง ตั้งค่าพารามิเตอร์นี้เป็น true เพื่อดึงข้อมูลฟีดส่วนของช่องที่เชื่อมโยงกับช่อง YouTube ของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์
พารามิเตอร์ที่ไม่บังคับ
hl string
พารามิเตอร์นี้เลิกใช้งานแล้ว พารามิเตอร์ hl รองรับการดึงข้อมูลเมตาที่แปลแล้ว สำหรับส่วนของช่อง อย่างไรก็ตาม ฟังก์ชันนี้เลิกใช้งานแล้วใน YouTube Studio และในแอป YouTube
onBehalfOfContentOwner string
พารามิเตอร์นี้ใช้ได้เฉพาะในคำขอที่ได้รับอนุญาตอย่างถูกต้อง หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น

พารามิเตอร์ onBehalfOfContentOwner บ่งชี้ว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube หลายช่อง ซึ่งช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์ได้เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้โดยไม่ต้องระบุข้อมูลรับรองการตรวจสอบสิทธิ์สำหรับแต่ละช่อง บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์ต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ

เนื้อความของคำขอ

อย่าระบุเนื้อความของคำขอเมื่อเรียกเมธอดนี้

คำตอบ

หากทำสำเร็จ เมธอดนี้จะแสดงผลเนื้อหาการตอบกลับที่มีโครงสร้างดังต่อไปนี้

{
  "kind": "youtube#channelSectionListResponse",
  "etag": etag,
  "items": [
    channelSection Resource
  ]
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้กำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#channelSectionListResponse
etag etag
Etag ของทรัพยากรนี้
items[] list
รายการ ChannelSection ที่ตรงกับเกณฑ์คำขอ

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
forbidden (403) channelSectionForbidden ผู้ขอไม่มีสิทธิ์เข้าถึงส่วนช่องที่ขอ
invalidValue (400) idInvalid คำขอระบุรหัสส่วนของช่องที่ไม่ถูกต้อง
invalidValue (400) invalidCriteria ดำเนินการตามคำขอไม่สำเร็จเนื่องจากเกณฑ์ตัวกรองไม่ถูกต้อง
notFound (404) channelNotFound ไม่พบช่องที่เชื่อมโยงกับคำขอ
notFound (404) channelSectionNotFound ไม่พบส่วนของช่องที่เชื่อมโยงกับคำขอ

ลองใช้งาน

ใช้ APIs Explorer เพื่อเรียก API นี้และดูคำขอและการตอบกลับของ API