ChannelSections: insert

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