อัปโหลดภาพขนาดย่อของวิดีโอที่กําหนดเองไปยัง YouTube และตั้งค่าสําหรับวิดีโอ
วิธีการนี้รองรับการอัปโหลดสื่อ ไฟล์ที่อัปโหลดต้องเป็นไปตามข้อจํากัดเหล่านี้
- ขนาดไฟล์สูงสุด: 2MB
- ประเภท MIME ของสื่อที่ยอมรับ:
image/jpeg
,image/png
,application/octet-stream
ผลกระทบของโควต้า: การเรียกไปยังวิธีการนี้มีโควต้าประมาณ 50 หน่วย
กรณีการใช้งานทั่วไป
ส่งคำขอ
คำขอ 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 ระบุว่าข้อมูลรับรองการให้สิทธิ์ของคําขอระบุผู้ใช้ CMS ของ YouTube ที่ดําเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหาของ 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 และการตอบกลับ