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