Thumbnails: set

YouTube पर कस्टम वीडियो थंबनेल अपलोड करता है और उसे किसी वीडियो के लिए सेट करता है.

इस तरीके से मीडिया अपलोड किया जा सकता है. अपलोड की गई फ़ाइलों को इन शर्तों का पालन करना होगा:

• फ़ाइल का ज़्यादा से ज़्यादा साइज़: 50 एमबी
• स्वीकार किए जाने वाले मीडिया एमआईएमई टाइप: image/jpeg, image/png, application/octet-stream

कोटा पर असर: इस तरीके को कॉल करने पर, करीब 50 यूनिट की कोटा लागत आती है.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें).

दायरा
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

यहां दी गई टेबल में उन पैरामीटर की सूची दी गई है जो इस क्वेरी के साथ काम करते हैं. यहां दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
videoId	string videoId पैरामीटर, YouTube वीडियो का आईडी तय करता है. इसके लिए, कस्टम वीडियो थंबनेल दिया जाता है.
वैकल्पिक पैरामीटर
onBehalfOfContentOwner	string ध्यान दें: यह पैरामीटर सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध के अनुमति क्रेडेंशियल, YouTube सीएमएस के उस उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर, YouTube कॉन्टेंट पार्टनर के लिए है. ये पार्टनर, कई YouTube चैनलों का मालिकाना हक रखते हैं और उन्हें मैनेज करते हैं. इससे कॉन्टेंट के मालिकों को एक बार पुष्टि करने के बाद, अपने सभी वीडियो और चैनल के डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं होती. यह ज़रूरी है कि उपयोगकर्ता जिस सीएमएस खाते की पुष्टि करे वह YouTube कॉन्टेंट के मालिक के खाते से लिंक हो.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, अपलोड की जा रही थंबनेल इमेज शामिल होती है. अनुरोध के मुख्य हिस्से में thumbnail संसाधन मौजूद नहीं है.

जवाब

अगर यह तरीका सही से काम करता है, तो जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर शामिल होता है:

{
  "kind": "youtube#thumbnailSetResponse",
  "etag": etag,
  "items": [
    thumbnail resource
  ]
}

प्रॉपर्टी

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

प्रॉपर्टी
kind	string इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#thumbnailSetResponse होगी.
etag	etag इस संसाधन का ETag.
items[]	list थंबनेल की सूची.

गड़बड़ियां

यहां दी गई टेबल में, गड़बड़ी के उन मैसेज के बारे में बताया गया है जो इस तरीके को कॉल करने पर, एपीआई से मिल सकते हैं. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज वाला दस्तावेज़ देखें.

गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
badRequest (400)	invalidImage	दी गई इमेज का कॉन्टेंट अमान्य है.
badRequest (400)	mediaBodyRequired	अनुरोध में इमेज का कॉन्टेंट शामिल नहीं है.
forbidden (403)	forbidden	चुने गए वीडियो के लिए थंबनेल सेट नहीं किया जा सकता. ऐसा हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो.
forbidden (403)	forbidden	प्रमाणित उपयोगकर्ता के पास, कस्टम वीडियो थंबनेल अपलोड करने और उन्हें सेट करने की अनुमतियां नहीं हैं.
notFound (404)	videoNotFound	जिस वीडियो के लिए थंबनेल इमेज शामिल करनी है वह नहीं मिल रहा है. अनुरोध के videoId पैरामीटर की वैल्यू की जांच करके पक्का करें कि वह सही हो.
tooManyRequests (429)	uploadRateLimitExceeded	चैनल ने हाल ही में बहुत ज़्यादा थंबनेल अपलोड किए हैं. कृपया बाद में फिर से अनुरोध करें.

इसे आज़माएं!

इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और जवाब देखें.