Thumbnails

ทรัพยากร 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
ความสูงของรูปภาพ