VideoCategories: list

แสดงรายการหมวดหมู่ที่เชื่อมโยงกับวิดีโอ YouTube ได้

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

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

ส่งคำขอ

คำขอ HTTP

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

พารามิเตอร์

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

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part string
พารามิเตอร์ part จะระบุพร็อพเพอร์ตี้ของทรัพยากร videoCategory ที่การตอบกลับจาก API จะรวมไว้ ตั้งค่าพารามิเตอร์เป็น snippet
ตัวกรอง (ระบุพารามิเตอร์ต่อไปนี้เพียง 1 รายการ)
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 ใช้เมธอด videoCategories.list เพื่อดึงข้อมูลรายการค่าที่ถูกต้อง

ลองใช้งาน

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