ChannelBanners: insert

YouTube पर चैनल की बैनर इमेज अपलोड करता है. इस तरीके में, चैनल के बैनर की इमेज अपडेट करने की तीन चरणों वाली प्रोसेस के पहले दो चरण दिखाए गए हैं:

  1. YouTube पर बाइनरी इमेज का डेटा अपलोड करने के लिए, channelBanners.insert तरीके को कॉल करें. इमेज का आसपेक्ट रेशियो 16:9 होना चाहिए और उसका साइज़ कम से कम 2048 x 1152 पिक्सल होना चाहिए. हमारा सुझाव है कि आप 2560 x 1440 पिक्सल की इमेज अपलोड करें.
  2. पहले चरण के लिए एपीआई से मिले रिस्पॉन्स से, url प्रॉपर्टी की वैल्यू निकालें.
  3. चैनल की ब्रैंडिंग सेटिंग अपडेट करने के लिए, channels.update तरीका अपनाएं. brandingSettings.image.bannerExternalUrl प्रॉपर्टी की वैल्यू को दूसरे चरण में मिले यूआरएल पर सेट करें.

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

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

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

अनुरोध

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

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानने के लिए, OAuth 2.0 का ऑथराइज़ेशन लागू करना लेख पढ़ें.

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

पैरामीटर

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

पैरामीटर
ज़रूरी नहीं पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है.

ध्यान दें: यह पैरामीटर सिर्फ़ YouTube कॉन्टेंट पार्टनर के लिए है.

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

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

इस तरीके को कॉल करते समय, अनुरोध बॉडी न दें.

जवाब

अगर यह तरीका कामयाब होता है, तो यह जवाब के मुख्य हिस्से में channelBanner संसाधन दिखाता है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) bannerAlbumFull आपके YouTube चैनल के आर्ट एल्बम में बहुत ज़्यादा इमेज हैं. इस समस्या को ठीक करने के लिए, Google Photos पर जाएं. इसके बाद, एल्बम पेज पर जाएं और उस एल्बम से कुछ इमेज हटाएं.
badRequest (400) mediaBodyRequired अनुरोध में इमेज का कॉन्टेंट शामिल नहीं है.

इसे आज़माएं!

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