ChannelSections: list

यह एपीआई अनुरोध की शर्तों से मेल खाने वाले channelSection संसाधनों की सूची दिखाता है.

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

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

अनुरोध

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

GET https://www.googleapis.com/youtube/v3/channelSections

पैरामीटर

यहां दी गई टेबल में उन पैरामीटर की सूची दी गई है जो इस क्वेरी के साथ काम करते हैं. यहां दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part	string part पैरामीटर, channelSection रिसॉर्स प्रॉपर्टी की कॉमा लगाकर अलग की गई सूची के बारे में बताता है. इस सूची में एक या उससे ज़्यादा प्रॉपर्टी शामिल होती हैं. एपीआई के जवाब में ये प्रॉपर्टी शामिल होंगी. अगर पैरामीटर ऐसी प्रॉपर्टी की पहचान करता है जिसमें चाइल्ड प्रॉपर्टी शामिल हैं, तो चाइल्ड प्रॉपर्टी को जवाब में शामिल किया जाएगा. उदाहरण के लिए, channelSection रिसॉर्स में, snippet प्रॉपर्टी में अन्य प्रॉपर्टी शामिल होती हैं. जैसे, सेक्शन के लिए डिसप्ले टाइटल. part=snippet सेट करने पर, एपीआई से मिले जवाब में नेस्ट की गई वे सभी प्रॉपर्टी भी शामिल होंगी. यहां दी गई सूची में, part के वे नाम शामिल हैं जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है: contentDetails id snippet
फ़िल्टर (इनमें से सिर्फ़ एक पैरामीटर की जानकारी दें)
channelId	string channelId पैरामीटर, YouTube चैनल का आईडी तय करता है. अगर किसी अनुरोध में इस पैरामीटर के लिए कोई वैल्यू दी गई है, तो एपीआई सिर्फ़ उस चैनल के सेक्शन दिखाएगा.
id	string id पैरामीटर, कॉमा लगाकर अलग किए गए आईडी की सूची दिखाता है. यह सूची, वापस लाए जा रहे channelSection संसाधनों की खास तौर पर पहचान करती है. channelSection रिसोर्स में, id प्रॉपर्टी से सेक्शन के आईडी के बारे में पता चलता है.
mine	boolean इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है. इस पैरामीटर की वैल्यू को true पर सेट करें, ताकि पुष्टि किए गए उपयोगकर्ता के YouTube चैनल से जुड़े चैनल सेक्शन का फ़ीड वापस पाया जा सके.
वैकल्पिक पैरामीटर
hl	string इस पैरामीटर का इस्तेमाल बंद कर दिया गया है. hl पैरामीटर की मदद से, चैनल के किसी सेक्शन के लिए स्थानीय भाषा में मेटाडेटा हासिल किया जा सकता था. हालांकि, YouTube Studio और YouTube ऐप्लिकेशन में इस सुविधा को बंद कर दिया गया है.
onBehalfOfContentOwner	string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध के अनुमति क्रेडेंशियल, YouTube सीएमएस के उस उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर, YouTube के उन कॉन्टेंट पार्टनर के लिए है जिनके पास कई YouTube चैनलों का मालिकाना हक है और जो उन्हें मैनेज करते हैं. इससे कॉन्टेंट के मालिकों को एक बार पुष्टि करने के बाद, अपने सभी वीडियो और चैनल के डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस सीएमएस खाते से पुष्टि करता है वह YouTube कॉन्टेंट के मालिकाना हक वाले खाते से लिंक होना चाहिए.

अनुरोध का मुख्य भाग

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका सही से काम करता है, तो जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर शामिल होता है:

{
  "kind": "youtube#channelSectionListResponse",
  "etag": etag,
  "items": [
    channelSection Resource
  ]
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind	string इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#channelSectionListResponse होगी.
etag	etag इस संसाधन का ETag.
items[]	list अनुरोध की शर्तों से मेल खाने वाले ChannelSection की सूची.

गड़बड़ियां

यहां दी गई टेबल में, गड़बड़ी के उन मैसेज के बारे में बताया गया है जो इस तरीके को कॉल करने पर, एपीआई से मिल सकते हैं. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज वाला दस्तावेज़ देखें.

गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
forbidden (403)	channelSectionForbidden	अनुरोध करने वाले व्यक्ति को, अनुरोध किए गए चैनल सेक्शन ऐक्सेस करने की अनुमति नहीं है.
invalidValue (400)	idInvalid	अनुरोध में चैनल सेक्शन का अमान्य आईडी दिया गया है.
invalidValue (400)	invalidCriteria	फ़िल्टर करने की शर्तें अमान्य होने की वजह से, अनुरोध पूरा नहीं किया जा सका.
notFound (404)	channelNotFound	अनुरोध से जुड़ा चैनल नहीं मिला.
notFound (404)	channelSectionNotFound	अनुरोध से जुड़ा चैनल सेक्शन नहीं मिला.

इसे आज़माएं!

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