แสดงผลรายการหมวดหมู่ที่สามารถเชื่อมโยงกับวิดีโอ YouTube
ผลกระทบต่อโควต้า: การเรียกใช้วิธีการนี้มีโควต้า ซึ่งมี 1 หน่วย
กรณีการใช้งานทั่วไป
ส่งคำขอ
คำขอ HTTP
GET https://www.googleapis.com/youtube/v3/videoCategories
พารามิเตอร์
ตารางต่อไปนี้จะแสดงพารามิเตอร์ที่คําค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา
พารามิเตอร์ | ||
---|---|---|
พารามิเตอร์ที่จําเป็น | ||
part |
string พารามิเตอร์ part จะระบุพร็อพเพอร์ตี้ทรัพยากร videoCategory ที่การตอบสนองของ API จะรวมอยู่ด้วย กําหนดค่าพารามิเตอร์เป็น snippet
|
|
ตัวกรอง (ระบุพารามิเตอร์ตัวใดตัวหนึ่งต่อไปนี้) | ||
id |
string พารามิเตอร์ id จะระบุรายการรหัสหมวดหมู่วิดีโอที่คั่นด้วยคอมมาสําหรับทรัพยากรที่คุณกําลังเรียกดู |
|
regionCode |
string พารามิเตอร์ regionCode จะสั่งให้ API แสดงผลรายการหมวดหมู่วิดีโอที่พร้อมใช้งานในประเทศที่ระบุ ค่าพารามิเตอร์คือรหัสประเทศตามมาตรฐาน ISO 3166-1 alpha-2 |
|
พารามิเตอร์ที่ไม่บังคับ | ||
hl |
string พารามิเตอร์ hl จะระบุภาษาที่ควรใช้สําหรับค่าข้อความในการตอบกลับ API ค่าเริ่มต้นคือ en_US |
เนื้อหาของคำขอ
ไม่ต้องให้เนื้อหาคําขอเมื่อเรียกใช้วิธีการนี้
คำตอบ
หากสําเร็จ วิธีนี้จะแสดงผลเนื้อหาการตอบกลับที่มีโครงสร้างต่อไปนี้
{ "kind": "youtube#videoCategoryListResponse", "etag": etag, "nextPageToken": string, "prevPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ videoCategory resource ] }
พร็อพเพอร์ตี้
ตารางต่อไปนี้กําหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
kind |
string ระบุประเภทของทรัพยากร API ค่านี้จะเป็น youtube#videoCategoryListResponse |
etag |
etag Etag ของทรัพยากรนี้ |
nextPageToken |
string โทเค็นที่ใช้เป็นค่าของพารามิเตอร์ pageToken เพื่อดึงหน้าถัดไปในชุดผลลัพธ์ได้ |
prevPageToken |
string โทเค็นที่ใช้เป็นค่าของพารามิเตอร์ pageToken เพื่อดึงหน้าก่อนหน้าในชุดผลลัพธ์ได้ |
pageInfo |
object ออบเจ็กต์ pageInfo จะสรุปข้อมูลการแบ่งหน้าสําหรับชุดผลลัพธ์ |
pageInfo.totalResults |
integer จํานวนผลลัพธ์ทั้งหมดในชุดผลลัพธ์ |
pageInfo.resultsPerPage |
integer จํานวนผลลัพธ์ที่รวมอยู่ในการตอบกลับ API |
items[] |
list รายการหมวดหมู่วิดีโอที่เชื่อมโยงกับวิดีโอ YouTube ได้ ในแผนที่นี้ รหัสหมวดหมู่วิดีโอคือคีย์แผนที่ และค่าจะเป็นทรัพยากร videoCategory ที่เกี่ยวข้อง |
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด
ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
---|---|---|
notFound (404) |
videoCategoryNotFound |
ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ id ใช้เมธอด videoCategory.list เพื่อเรียกข้อมูลรายการค่าที่ถูกต้อง |
ลองใช้เลย
ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคําขอและการตอบกลับ API