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
इमेज की ऊंचाई.