ChannelSections: update

किसी चैनल के सेक्शन को अपडेट करता है.

कोटे पर असर: इस तरीके को कॉल करने पर, कोटे की 50 यूनिट खर्च होती हैं.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

PUT 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 के कई अलग-अलग चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इससे कॉन्टेंट के मालिक, एक बार पुष्टि करके अपने सभी वीडियो और चैनल के डेटा का ऐक्सेस पा सकते हैं. इसके लिए, उन्हें हर चैनल के लिए अनुमति के क्रेडेंशियल देने की ज़रूरत नहीं होती. जिस CMS खाते से उपयोगकर्ता पुष्टि करता है वह, बताए गए 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) idInvalid id प्रॉपर्टी में, चैनल के सेक्शन का अमान्य आईडी तय किया गया है.
invalidValue (400) idRequired id प्रॉपर्टी में, अपडेट किए जा रहे चैनल के सेक्शन की पहचान करने वाली वैल्यू तय करना ज़रूरी है.
invalidValue (400) inValidPosition snippet.position प्रॉपर्टी में, अमान्य वैल्यू शामिल है.
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) channelSectionNotFound अपडेट किया जाने वाला चैनल का सेक्शन नहीं मिला.
notFound (404) playlistNotFound बताई गई एक या उससे ज़्यादा प्लेलिस्ट नहीं मिलीं.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई अनुरोध और जवाब को देखने के लिए, APIs Explorer का इस्तेमाल करें.