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