पुष्टि किए गए उपयोगकर्ता के चैनल में चैनल सेक्शन जोड़ता है. किसी चैनल पर ज़्यादा से ज़्यादा 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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.