ChannelBanners: insert

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

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

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

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य हिस्से में channelबैनर रिसॉर्स दिखता है.

गड़बड़ियां

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

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

इसे आज़माएं!

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