ดึงข้อมูลรายการสถิติของวิดีโอที่ตรงกับพารามิเตอร์คำขอ 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 ที่คุณรวมไว้ในค่าพารามิเตอร์ได้
|
|
| พารามิเตอร์ที่ไม่บังคับ | ||
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 |
etagEtag ของทรัพยากรนี้ |
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 ทั่วไปที่ระบุไว้ในเอกสารประกอบข้อความแสดงข้อผิดพลาด