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 का इस्तेमाल करें.