पुष्टि किए गए उपयोगकर्ता के चैनल में चैनल सेक्शन जोड़ता है. किसी चैनल पर, ज़्यादा से ज़्यादा 10 शेल्फ़ बनाई जा सकती हैं.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 50 यूनिट हो जाती है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध करें
एचटीटीपी अनुरोध
POST https://www.googleapis.com/youtube/v3/channelSections
अनुमति दें
इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.
दायरा |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string part कार्रवाई के लिए दो पैरामीटर इस्तेमाल किए जाते हैं. यह उन प्रॉपर्टी की पहचान करता है जिन्हें राइट ऑपरेशंस सेट करता है. साथ ही, उन प्रॉपर्टी की भी पहचान करता है जिन्हें एपीआई रिस्पॉन्स में शामिल किया जाता है.नीचे दी गई सूची में part नाम शामिल हैं, जिन्हें आप पैरामीटर वैल्यू में शामिल कर सकते हैं:
|
|
ज़रूरी पैरामीटर | ||
onBehalfOfContentOwner |
string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि के लिए, किसी YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान की गई है. यह उपयोगकर्ता, पैरामीटर वैल्यू में तय किए गए कॉन्टेंट के मालिक की तरफ़ से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें प्रबंधित करते हैं. इसकी मदद से कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं. साथ ही, अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल नहीं देने होंगे. जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से उपयोगकर्ता की पुष्टि होती है उसे YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए. |
|
onBehalfOfContentOwnerChannel |
string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwnerChannel पैरामीटर से उस चैनल के YouTube चैनल आईडी का पता चलता है जिसमें वीडियो जोड़ा जा रहा है. यह पैरामीटर तब ज़रूरी होता है, जब कोई अनुरोध onBehalfOfContentOwner पैरामीटर के लिए वैल्यू तय करता है. साथ ही, इसका इस्तेमाल सिर्फ़ उसी पैरामीटर के साथ किया जा सकता है. साथ ही, अनुरोध को ऐसे कॉन्टेंट मैनेजमेंट सिस्टम से लिंक किया जाना चाहिए जो कॉन्टेंट के मालिक से जुड़ा हो और onBehalfOfContentOwner पैरामीटर के बारे में बताता हो. आखिर में, onBehalfOfContentOwnerChannel पैरामीटर की वैल्यू के बारे में बताने वाला चैनल, उस कॉन्टेंट के मालिक से जुड़ा होना चाहिए जिसका onBehalfOfContentOwner पैरामीटर तय करता है.यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास अलग-अलग YouTube चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है. इसकी मदद से कॉन्टेंट के मालिक एक बार में पुष्टि कर सकते हैं. साथ ही, पैरामीटर की वैल्यू में बताए गए चैनल की तरफ़ से कार्रवाई कर सकते हैं. इसके लिए, हर अलग चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में channelSection रिसॉर्स उपलब्ध कराएं. उस संसाधन के लिए:
-
आपको इन प्रॉपर्टी के लिए एक मान तय करना होगा:
snippet.type
-
आपके पास इन प्रॉपर्टी के लिए वैल्यू सेट करने का विकल्प है:
snippet.type
snippet.title
snippet.position
contentDetails.playlists[]
contentDetails.channels[]
जवाब
अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य भाग में channelSection रिसॉर्स मिलता है.
गड़बड़ियां
इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो इस तरीके से कॉल करने पर एपीआई मिल सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
badRequest (400) |
notEditable |
यह चैनल सेक्शन नहीं बनाया जा सकता. |
badRequest (400) |
typeRequired |
channelSection संसाधन को snippet.type फ़ील्ड के लिए एक वैल्यू तय करना होगा. |
forbidden (403) |
channelSectionForbidden |
अनुरोध सही तरीके से प्रमाणित नहीं है या इस चैनल पर काम नहीं करता. |
invalidValue (400) |
channelNotActive |
कम से कम एक चैनल चालू नहीं है. |
invalidValue (400) |
channelsDuplicated |
डुप्लीकेट चैनलों के बारे में बताने की वजह से, अनुरोध पूरा नहीं हो सका. |
invalidValue (400) |
channelsNeeded |
अगर snippet.type प्रॉपर्टी की वैल्यू multipleChannels है, तो contentDetails.channels[] प्रॉपर्टी होनी चाहिए और उसे कम से कम एक चैनल होना चाहिए. |
invalidValue (400) |
channelsNotExpected |
अनुरोध के साथ दिए गए संसाधन ने contentDetails.channels[] प्रॉपर्टी के लिए एक वैल्यू तय की है. हालांकि, ऐसा हो सकता है कि इस तरह के चैनल सेक्शन के लिए चैनल सही न हों. |
invalidValue (400) |
contentDetailsNeeded |
आप जिस रिसॉर्स को शामिल कर रहे हैं, उसमें इस तरह के चैनल सेक्शन के लिए एक contentDetails ऑब्जेक्ट होना चाहिए. |
invalidValue (400) |
inValidPosition |
snippet.position प्रॉपर्टी में कोई अमान्य वैल्यू है. |
invalidValue (400) |
maxChannelSectionExceeded |
अनुरोध पूरा नहीं किया जा सकता, क्योंकि चैनल पर पहले से ही उतने सेक्शन मौजूद हैं जितने की अनुमति है. |
invalidValue (400) |
maxChannelsExceeded |
अनुरोध पूरा नहीं हुआ, क्योंकि चैनल सेक्शन में कई चैनल शामिल करने की कोशिश की गई थी. |
invalidValue (400) |
maxPlaylistExceeded |
अनुरोध पूरा नहीं हुआ, क्योंकि चैनल के सेक्शन में कई प्लेलिस्ट शामिल करने की कोशिश की गई थी. |
invalidValue (400) |
onePlaylistNeeded |
अगर snippet.type प्रॉपर्टी की वैल्यू singlePlaylist है, तो contentDetails.playlists[] प्रॉपर्टी में सिर्फ़ एक प्लेलिस्ट मौजूद होनी चाहिए. |
invalidValue (400) |
ownChannelInChannels |
उस चैनल पर दिखाई देने वाले चैनल सेक्शन में खुद का चैनल शामिल नहीं किया जा सकता. |
invalidValue (400) |
playlistIsPrivate |
बताई गई एक या उससे ज़्यादा प्लेलिस्ट निजी हैं. इसलिए, इन्हें चैनल सेक्शन में शामिल नहीं किया जा सकता. |
invalidValue (400) |
playlistsDuplicated |
डुप्लीकेट प्लेलिस्ट की जानकारी होने की वजह से अनुरोध पूरा नहीं हुआ. |
invalidValue (400) |
playlistsNeeded |
अगर snippet.type प्रॉपर्टी की वैल्यू singlePlaylist या multiplePlaylists है, तो contentDetails.playlists[] प्रॉपर्टी की जानकारी दी जानी चाहिए. |
invalidValue (400) |
playlistsNotExpected |
अनुरोध के साथ दिए गए संसाधन ने contentDetails.playlists[] प्रॉपर्टी के लिए एक वैल्यू तय की है. हालांकि, इस तरह के चैनल सेक्शन के लिए प्लेलिस्ट ज़रूरी नहीं हैं. |
invalidValue (400) |
snippetNeeded |
चैनल वाला सेक्शन बनाने के लिए आपको snippet बताना होगा. |
invalidValue (400) |
titleLengthExceeded |
snippet.title प्रॉपर्टी की वैल्यू बहुत लंबी है. |
invalidValue (400) |
titleRequired |
अगर snippet.type प्रॉपर्टी की वैल्यू multiplePlaylists या multipleChannels है, तो आपको snippet.title प्रॉपर्टी के लिए वैल्यू की जानकारी देकर, सेक्शन का शीर्षक सेट करना होगा. |
notFound (404) |
channelNotFound |
बताए गए एक या उससे ज़्यादा चैनल नहीं मिले. |
notFound (404) |
playlistNotFound |
दी गई एक या ज़्यादा प्लेलिस्ट नहीं मिली. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.