YouTube पर चैनल की बैनर इमेज अपलोड करता है. इस तरीके में, चैनल के बैनर की इमेज अपडेट करने की तीन चरणों वाली प्रोसेस के पहले दो चरण दिखाए गए हैं:
- YouTube पर बाइनरी इमेज का डेटा अपलोड करने के लिए,
channelBanners.insertतरीके को कॉल करें. इमेज का आसपेक्ट रेशियो 16:9 होना चाहिए और उसका साइज़ कम से कम 2048 x 1152 पिक्सल होना चाहिए. हमारा सुझाव है कि आप 2560 x 1440 पिक्सल की इमेज अपलोड करें. - पहले चरण के लिए एपीआई से मिले रिस्पॉन्स से,
urlप्रॉपर्टी की वैल्यू निकालें. - चैनल की ब्रैंडिंग सेटिंग अपडेट करने के लिए,
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 का इस्तेमाल करें.