Thumbnails

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

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