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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और जवाब देखें.