इससे चैनल के सेक्शन में बदलाव होता है.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 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 नाम शामिल हैं, जिन्हें आप पैरामीटर वैल्यू में शामिल कर सकते हैं:
|
|
ज़रूरी पैरामीटर | ||
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 का इस्तेमाल करें.