Thumbnails

thumbnail ระบุขนาดรูปภาพปกต่างๆ ที่เชื่อมโยงกับทรัพยากร โปรดทราบลักษณะของภาพขนาดย่อต่อไปนี้

  • พร็อพเพอร์ตี้ snippet.thumbnails ของทรัพยากรคือออบเจ็กต์ที่ระบุรูปภาพขนาดย่อที่พร้อมใช้งานสำหรับทรัพยากรนั้น
  • thumbnail ทรัพยากรประกอบด้วยชุดออบเจ็กต์ ชื่อของออบเจ็กต์แต่ละรายการ (default, medium, high ฯลฯ) หมายถึงขนาดรูปภาพขนาดย่อ
  • แหล่งข้อมูลประเภทต่างๆ อาจรองรับขนาดภาพปกที่แตกต่างกัน
  • แหล่งข้อมูลประเภทต่างๆ อาจกำหนดขนาดที่แตกต่างกันสำหรับภาพปกที่มีชื่อเดียวกัน เช่น โดยปกติแล้วdefaultภาพขนาดย่อสำหรับvideoแหล่งข้อมูลจะมีขนาด 120x90 พิกเซล และdefaultภาพขนาดย่อสำหรับchannelแหล่งข้อมูลจะมีขนาด 88x88 พิกเซล
  • แหล่งข้อมูลประเภทเดียวกันอาจยังมีขนาดภาพขนาดย่อที่แตกต่างกันสำหรับรูปภาพบางรูป ทั้งนี้ขึ้นอยู่กับความละเอียดของรูปภาพหรือเนื้อหาต้นฉบับที่อัปโหลดไปยัง 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
ความสูงของรูปภาพ