YouTube पर चैनल की बैनर इमेज अपलोड करता है. यह तरीका, किसी चैनल की बैनर इमेज को अपडेट करने के तीन चरणों की प्रोसेस के पहले दो चरणों को दिखाता है:
- YouTube पर बाइनरी इमेज का डेटा अपलोड करने के लिए,
channelBanners.insertवाला तरीका इस्तेमाल करें. इमेज का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 होना चाहिए और वह कम से कम 2048x1152 पिक्सल की होनी चाहिए. हमारा सुझाव है कि आप 2560 पिक्सल x 1440 पिक्सल वाली इमेज अपलोड करें. - एपीआई के पहले चरण में मिले रिस्पॉन्स से
urlप्रॉपर्टी की वैल्यू निकालें. - चैनल की ब्रैंडिंग सेटिंग को अपडेट करने के लिए,
channels.updateवाले तरीके को कॉल करें.brandingSettings.image.bannerExternalUrlप्रॉपर्टी की वैल्यू को, दूसरे चरण में मिले यूआरएल पर सेट करें.
इस तरीके से, मीडिया अपलोड किया जा सकता है. अपलोड की गई फ़ाइलें इन सीमाओं के अनुरूप होनी चाहिए:
- फ़ाइल का ज़्यादा से ज़्यादा साइज़: 6 एमबी
- स्वीकार किए गए मीडिया के MIME टाइप:
image/jpeg,image/png,application/octet-stream
कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट का कोटा शुल्क होगा.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert
अनुमति
इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
| स्कोप |
|---|
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 सीएमएस के किसी ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक होता है और उन्हें मैनेज करने का अधिकार होता है. इससे कॉन्टेंट के मालिकों को एक बार पुष्टि करने के साथ-साथ, अपने वीडियो और चैनल के पूरे डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं पड़ती. उपयोगकर्ता जिस कॉन्टेंट मैनेजमेंट सिस्टम से पुष्टि करता है वह खाता, YouTube कॉन्टेंट के उस मालिक से जुड़ा होना चाहिए. |
|
अनुरोध का मुख्य भाग
इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.
जवाब
अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में channelBanner संसाधन दिखता है.
गड़बड़ियां
नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.
| गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
|---|---|---|
badRequest (400) |
bannerAlbumFull |
आपके YouTube चैनल आर्ट एल्बम में बहुत ज़्यादा इमेज हैं. कृपया http://photos.google.com पर जाएं. एल्बम पेज पर जाएं और उस एल्बम की कुछ इमेज हटाएं. |
badRequest (400) |
mediaBodyRequired |
अनुरोध में इमेज का कॉन्टेंट शामिल नहीं है. |
इसे आज़माएं!
इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.