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
จำนวนครั้งที่มีการดูวิดีโอ

สำหรับวิดีโอทุกรูปแบบ (วิดีโอแบบยาว, ไลฟ์สด และ Shorts) viewCount จะรวมการดูร่วมกันเมื่อมีผู้คนหลายคนดูวิดีโอร่วมกันบนหน้าจอทีวี
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 ทั่วไปที่ระบุไว้ในเอกสารประกอบข้อความแสดงข้อผิดพลาด