อัปโหลดภาพปกวิดีโอที่ทำเองไปยัง YouTube และตั้งเป็นวิดีโอ
วิธีนี้รองรับการอัปโหลดสื่อ ไฟล์ที่อัปโหลดต้องเป็นไปตามข้อจำกัดต่อไปนี้
- ขนาดไฟล์สูงสุด: 2 MB
- ประเภท MIME ของสื่อที่ยอมรับ:
image/jpeg
,image/png
,application/octet-stream
ผลกระทบของโควต้า: การเรียกใช้วิธีการนี้มีค่าใช้จ่ายโควต้าประมาณ 50 หน่วย
Use Case ทั่วไป
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์อย่างน้อย 1 ขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
พารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงอยู่เป็นพารามิเตอร์การค้นหา
พารามิเตอร์ | ||
---|---|---|
พารามิเตอร์ที่จำเป็น | ||
videoId |
string พารามิเตอร์ videoId ระบุรหัสวิดีโอ YouTube ที่ระบุภาพปกวิดีโอที่ทำเอง |
|
พารามิเตอร์ที่ไม่บังคับ | ||
onBehalfOfContentOwner |
string หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube โดยเฉพาะ พารามิเตอร์ onBehalfOfContentOwner บ่งชี้ว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube หลายช่อง ซึ่งช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์เพียงครั้งเดียวและมีสิทธิ์เข้าถึงข้อมูลวิดีโอและช่องทั้งหมดของตนโดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับแต่ละช่อง บัญชี CMS จริงที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ |
เนื้อหาของคำขอ
ส่วนเนื้อหาของคำขอมีภาพขนาดย่อที่คุณกำลังอัปโหลด เนื้อหาคำขอไม่มีทรัพยากร thumbnail
คำตอบ
หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบสนองที่มีโครงสร้างต่อไปนี้
{ "kind": "youtube#thumbnailSetResponse", "etag": etag, "items": [ thumbnail resource ] }
พร็อพเพอร์ตี้
ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
kind |
string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#thumbnailSetResponse |
etag |
etag Etag ของแหล่งข้อมูลนี้ |
items[] |
list รายการภาพปก |
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด
ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
---|---|---|
badRequest (400) |
invalidImage |
เนื้อหาของรูปภาพที่ให้ไว้ไม่ถูกต้อง |
badRequest (400) |
mediaBodyRequired |
คำขอไม่รวมเนื้อหารูปภาพ |
forbidden (403) |
forbidden |
ตั้งค่าภาพปกสำหรับวิดีโอที่ระบุไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง |
forbidden (403) |
forbidden |
ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วไม่มีสิทธิ์อัปโหลดและตั้งค่าภาพขนาดย่อของวิดีโอที่กำหนดเอง |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามแทรกภาพขนาดย่อ โปรดตรวจสอบค่าของพารามิเตอร์ videoId ของคําขอเพื่อให้แน่ใจว่าถูกต้อง |
tooManyRequests (429) |
uploadRateLimitExceeded |
ช่องอัปโหลดภาพขนาดย่อมากเกินไปเมื่อเร็วๆ นี้ โปรดลองส่งคำขออีกครั้งในภายหลัง |
ลองใช้เลย
ใช้ APIs Explorer เพื่อเรียกใช้ API นี้เพื่อดูคำขอและการตอบสนองของ API