Videos: batchGetStats

ดึงข้อมูลรายการสถิติของวิดีโอที่ตรงกับพารามิเตอร์คำขอ API

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

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/youtube/v3/videos:batchGetStats

การให้สิทธิ์

ต้องมีการตรวจสอบสิทธิ์เพื่อใช้เมธอดนี้กับวิดีโอที่ไม่เป็นสาธารณะ แต่ไม่จำเป็นสำหรับวิดีโอที่เป็นสาธารณะ หากมีการให้สิทธิ์ คำขอต้องได้รับอนุญาตด้วยขอบเขตอย่างน้อย 1 รายการต่อไปนี้ (ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

พารามิเตอร์

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

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

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

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

การตอบกลับ

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

{
  "kind": "youtube#batchGetStatsResponse",
  "etag": etag,
  "items": [
    {
      "kind": "youtube#videoStats",
      "etag": etag,
      "id": string,
      "snippet": {
        "publishTime": datetime
      },
      "statistics": {
        "viewCount": unsigned long,
        "likeCount": unsigned long,
        "commentCount": unsigned long
      },
      "contentDetails": {
        "duration": string,
        "durationMillis": unsigned long
      }
    }
  ],
  "summary": {
    "requestedVideoCount": unsigned long,
    "succeededVideoCount": unsigned long,
    "failedVideoCount": unsigned long,
    "failedVideoIds": [
      string
    ]
  }
}

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

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

พร็อพเพอร์ตี้
kind	string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#batchGetStatsResponse
etag	etag Etag ของทรัพยากรนี้
items[]	list รายการสถิติของวิดีโอที่ตรงกับเกณฑ์คำขอ
items[].id	string รหัสที่ YouTube ใช้เพื่อระบุวิดีโอที่ไม่ซ้ำกัน
items[].snippet.publishTime	datetime วันที่และเวลาที่อัปโหลดวิดีโอ
items[].statistics.viewCount	unsigned long จำนวนครั้งที่มีการดูวิดีโอ
items[].statistics.likeCount	unsigned long จำนวนผู้ใช้ที่ระบุว่าชอบวิดีโอ
items[].statistics.commentCount	unsigned long จำนวนความคิดเห็นของวิดีโอ
items[].contentDetails.duration	string ความยาวของวิดีโอ
items[].contentDetails.durationMillis	unsigned long ความยาวของวิดีโอเป็นมิลลิวินาที
summary	object ข้อมูลสรุปของคำขอ batchGetStats
summary.requestedVideoCount	unsigned long จำนวนวิดีโอที่ขอ
summary.succeededVideoCount	unsigned long จำนวนวิดีโอที่สำเร็จ
summary.failedVideoCount	unsigned long จำนวนวิดีโอที่ไม่สำเร็จ
summary.failedVideoIds[]	list รหัสวิดีโอที่ไม่สำเร็จ

ข้อผิดพลาด

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