Thumbnails

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

• किसी संसाधन की snippet.thumbnails प्रॉपर्टी एक ऑब्जेक्ट है, जो उस संसाधन के लिए उपलब्ध थंबनेल इमेज की पहचान करता है.
• thumbnail संसाधन में कई ऑब्जेक्ट होते हैं. हर ऑब्जेक्ट के नाम (default, medium, high वगैरह) से थंबनेल इमेज के साइज़ का पता चलता है.
• अलग-अलग संसाधनों में, थंबनेल इमेज का अलग-अलग साइज़ हो सकता है.
• अलग-अलग तरह के संसाधन, एक ही नाम वाली थंबनेल इमेज के अलग-अलग साइज़ को तय कर सकते हैं. उदाहरण के लिए, video संसाधन के लिए default की थंबनेल इमेज का साइज़ आम तौर पर 120 पिक्सल x 90 पिक्सल होता है. साथ ही, channel रिसॉर्स के लिए, default की थंबनेल इमेज का साइज़ आम तौर पर 88 x 88 पिक्सल होता है.
• 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 पिक्सल लंबा होता है. किसी चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है.
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 इमेज की ऊंचाई.