Thumbnails: set

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

इस तरीके से, मीडिया अपलोड किया जा सकता है. अपलोड की गई फ़ाइलें इन सीमाओं के अनुरूप होनी चाहिए:

  • फ़ाइल का ज़्यादा से ज़्यादा साइज़: 2 एमबी
  • स्वीकार किए गए मीडिया के MIME टाइप: 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
इस संसाधन का ईटैग.
items[] list
थंबनेल की सूची.

गड़बड़ियां

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

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

इसे आज़माएं!

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