Thumbnails: set

อัปโหลดภาพขนาดย่อของวิดีโอที่กําหนดเองไปยัง 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 และการตอบกลับ