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
  }
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है: