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 का इस्तेमाल करें.