ทรัพยากร thumbnail
ระบุขนาดภาพขนาดย่อที่แตกต่างกันที่เชื่อมโยงกับทรัพยากร โปรดคํานึงถึงลักษณะเฉพาะของภาพขนาดย่อต่อไปนี้
- พร็อพเพอร์ตี้
snippet.thumbnails
ของทรัพยากรคือออบเจ็กต์ที่ระบุภาพขนาดย่อของภาพขนาดย่อสําหรับทรัพยากรนั้น - ทรัพยากร
thumbnail
มีชุดออบเจ็กต์ ชื่อของออบเจ็กต์แต่ละรายการ (default
,medium
,high
ฯลฯ) หมายถึงขนาดภาพขนาดย่อ - ทรัพยากรประเภทต่างๆ อาจรองรับภาพขนาดย่อขนาดต่างๆ
- แหล่งข้อมูลประเภทต่างๆ อาจกําหนดขนาดที่แตกต่างกันสําหรับภาพขนาดย่อที่มีชื่อเดียวกัน ตัวอย่างเช่น ภาพขนาดย่อของ
default
สําหรับทรัพยากรvideo
มักจะเท่ากับ 120 x 90 พิกเซล และภาพขนาดย่อของdefault
สําหรับทรัพยากรchannel
มักจะอยู่ที่ 88 x 88 พิกเซล - แหล่งข้อมูลประเภทเดียวกันอาจยังมีขนาดภาพขนาดย่อที่แตกต่างกันสําหรับบางรูปภาพ ขึ้นอยู่กับความละเอียดของรูปภาพต้นฉบับหรือเนื้อหาที่อัปโหลดไปยัง YouTube เช่น วิดีโอ HD อาจรองรับภาพขนาดย่อที่มีความละเอียดสูงกว่าวิดีโอที่ไม่ใช่ HD
- ออบเจ็กต์แต่ละรายการที่มีข้อมูลเกี่ยวกับขนาดของภาพขนาดย่อจะมีพร็อพเพอร์ตี้
width
และพร็อพเพอร์ตี้height
อย่างไรก็ตาม ระบบอาจไม่แสดงผลคุณสมบัติความกว้างและความสูงสําหรับรูปภาพนั้น - หากภาพขนาดย่อที่อัปโหลดไม่ตรงกับขนาดที่กําหนด ระบบจะปรับขนาดรูปภาพให้ตรงกับขนาดที่ถูกต้องโดยไม่เปลี่ยนสัดส่วนภาพ รูปภาพไม่ได้ถูกครอบตัด แต่อาจมีแถบสีดําเพื่อให้ขนาดถูกต้อง
วิธีการ
API รองรับวิธีต่อไปนี้สําหรับทรัพยากร thumbnails
รายการ
- ตั้งค่า
- อัปโหลดภาพขนาดย่อของวิดีโอที่กําหนดเองไปยัง YouTube และตั้งค่าสําหรับวิดีโอ
การนําเสนอแหล่งข้อมูล
โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบทรัพยากร thumbnails
{ "default": { "url": string, "width": unsigned integer, "height": unsigned integer }, "medium": { "url": string, "width": unsigned integer, "height": unsigned integer }, "high": { "url": string, "width": unsigned integer, "height": unsigned integer }, "standard": { "url": string, "width": unsigned integer, "height": unsigned integer }, "maxres": { "url": string, "width": unsigned integer, "height": unsigned integer } }
พร็อพเพอร์ตี้
ตารางต่อไปนี้กําหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
default |
object ภาพขนาดย่อเริ่มต้น ภาพขนาดย่อเริ่มต้นสําหรับวิดีโอหรือทรัพยากรที่อ้างอิงถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120 พิกเซลและสูง 90 พิกเซล ภาพขนาดย่อเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและสูง 88 พิกเซล |
default.url |
string URL ของรูปภาพ |
default.width |
unsigned integer ความกว้างของรูปภาพ |
default.height |
unsigned integer ความสูงของรูปภาพ |
medium |
object ภาพขนาดย่อเวอร์ชันความละเอียดสูง สําหรับวิดีโอ (หรือทรัพยากรที่อ้างอิงถึงวิดีโอ) รูปภาพนี้จะมีความกว้าง 320 พิกเซลและสูง 180 พิกเซล สําหรับช่อง รูปภาพนี้จะมีความกว้าง 240 พิกเซลและสูง 240 พิกเซล |
medium.url |
string URL ของรูปภาพ |
medium.width |
unsigned integer ความกว้างของรูปภาพ |
medium.height |
unsigned integer ความสูงของรูปภาพ |
high |
object ภาพขนาดย่อเวอร์ชันความละเอียดสูง สําหรับวิดีโอ (หรือทรัพยากรที่อ้างอิงถึงวิดีโอ) รูปภาพนี้กว้าง 480 พิกเซลและสูง 360 พิกเซล สําหรับช่องหนึ่งๆ รูปภาพนี้จะมีความกว้าง 800 พิกเซลและสูง 800 พิกเซล |
high.url |
string URL ของรูปภาพ |
high.width |
unsigned integer ความกว้างของรูปภาพ |
high.height |
unsigned integer ความสูงของรูปภาพ |
standard |
object ภาพขนาดย่อเวอร์ชันความละเอียดสูงกว่าภาพความละเอียด high รูปภาพนี้พร้อมใช้งานสําหรับวิดีโอบางรายการและแหล่งข้อมูลอื่นๆ ที่อ้างอิงถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 640 พิกเซลและสูง 480 พิกเซล |
standard.url |
string URL ของรูปภาพ |
standard.width |
unsigned integer ความกว้างของรูปภาพ |
standard.height |
unsigned integer ความสูงของรูปภาพ |
maxres |
object ภาพขนาดย่อเวอร์ชันความละเอียดสูงสุด ขนาดรูปภาพนี้ใช้ได้กับวิดีโอบางรายการและทรัพยากรอื่นๆ ที่อ้างอิงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา รูปภาพนี้กว้าง 1280 พิกเซล และสูง 720 พิกเซล |
maxres.url |
string URL ของรูปภาพ |
maxres.width |
unsigned integer ความกว้างของรูปภาพ |
maxres.height |
unsigned integer ความสูงของรูปภาพ |