GuideCategories: list

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

ทั้งทรัพยากร 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