Thumbnails

thumbnail संसाधन, किसी थंबनेल से जुड़े अलग-अलग साइज़ की इमेज के बारे में बताता है. कृपया थंबनेल इमेज की इन विशेषताओं पर ध्यान दें:

• किसी संसाधन की snippet.thumbnails प्रॉपर्टी, एक ऑब्जेक्ट है जो उस संसाधन के लिए उपलब्ध थंबनेल इमेज की पहचान करता है.
• thumbnail संसाधन में कई ऑब्जेक्ट हैं. हर ऑब्जेक्ट का नाम (default, medium, high वगैरह), थंबनेल इमेज के साइज़ के बारे में बताता है.
• अलग-अलग तरह के रिसॉर्स, अलग-अलग साइज़ की थंबनेल इमेज के साथ काम कर सकते हैं.
• अलग-अलग तरह के रिसॉर्स के लिए एक जैसे नाम वाली थंबनेल इमेज के लिए, अलग-अलग साइज़ तय किए जा सकते हैं. उदाहरण के लिए, video रिसॉर्स की default थंबनेल इमेज आम तौर पर 120px x 90px होती है और channel संसाधन की default थंबनेल इमेज आम तौर पर 88px x 88px होती है.
• YouTube पर अपलोड किए जाने वाले ओरिजनल इमेज या वीडियो के हिसाब से, कुछ इमेज के थंबनेल अलग-अलग साइज़ के हो सकते हैं. उदाहरण के लिए, हो सकता है कि बिना एचडी वाले वीडियो के मुकाबले, एचडी वीडियो का रिज़ॉल्यूशन ज़्यादा हो.
• थंबनेल इमेज के साइज़ की जानकारी वाले हर ऑब्जेक्ट में width प्रॉपर्टी और height प्रॉपर्टी होती है. हालांकि, हो सकता है कि उस इमेज के लिए चौड़ाई और ऊंचाई की प्रॉपर्टी न दिखाई जाएं.
• अगर अपलोड की गई थंबनेल इमेज, ज़रूरी डाइमेंशन से मेल नहीं खाती, तो इमेज का साइज़ बदलकर उसका आसपेक्ट रेशियो या चौड़ाई-ऊंचाई का अनुपात बदले बिना सही साइज़ से मेल खाने के लिए बदल दिया जाता है. इमेज को काटा नहीं गया है, लेकिन उसमें काले रंग की पट्टियां शामिल की जा सकती हैं, ताकि आकार सही हो.

तरीके

एपीआई 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 पिक्सल लंबा होता है. आम तौर पर, वीडियो का रेफ़रंस, जैसे कि प्लेलिस्ट आइटम या खोज के नतीजे के तौर पर इस्तेमाल किया जाता है. चैनल के लिए डिफ़ॉल्ट थंबनेल 88px चौड़ा और 88px लंबा होता है.
default.url	string इमेज का यूआरएल.
default.width	unsigned integer इमेज की चौड़ाई.
default.height	unsigned integer इमेज की ऊंचाई.
medium	object थंबनेल इमेज का हाई रिज़ॉल्यूशन वर्शन. वीडियो (या किसी वीडियो का संदर्भ देने वाले संसाधन) के लिए, यह इमेज 320 पिक्सल चौड़ी और 180 पिक्सल लंबी है. चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल लंबी है.
medium.url	string इमेज का यूआरएल.
medium.width	unsigned integer इमेज की चौड़ाई.
medium.height	unsigned integer इमेज की ऊंचाई.
high	object थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन होता है. वीडियो (या संसाधन को बताने वाला संसाधन) के लिए, यह इमेज 480 पिक्सल चौड़ी और 360 पिक्सल लंबी है. चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी है.
high.url	string इमेज का यूआरएल.
high.width	unsigned integer इमेज की चौड़ाई.
high.height	unsigned integer इमेज की ऊंचाई.
standard	object थंबनेल इमेज का रिज़ॉल्यूशन वाला high वर्शन इससे भी ज़्यादा रिज़ॉल्यूशन वाला होता है. यह इमेज, वीडियो दिखाने वाले कुछ वीडियो और दूसरे संसाधनों के लिए उपलब्ध है, जैसे कि प्लेलिस्ट आइटम या खोज के नतीजे. यह इमेज 640 पिक्सल चौड़ी और 480 पिक्सल लंबी है.
standard.url	string इमेज का यूआरएल.
standard.width	unsigned integer इमेज की चौड़ाई.
standard.height	unsigned integer इमेज की ऊंचाई.
maxres	object थंबनेल इमेज का सबसे ज़्यादा रिज़ॉल्यूशन वाला वर्शन. इस इमेज का साइज़, कुछ वीडियो के लिए उपलब्ध है. साथ ही, यह उन संसाधनों के लिए भी उपलब्ध है जिनमें वीडियो के बारे में जानकारी होती है. जैसे, प्लेलिस्ट में मौजूद आइटम या खोज के नतीजे. यह इमेज 1280 पिक्सल चौड़ी और 720 पिक्सल लंबी है.
maxres.url	string इमेज का यूआरएल.
maxres.width	unsigned integer इमेज की चौड़ाई.
maxres.height	unsigned integer इमेज की ऊंचाई.