ChannelSections: list

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

कोटा पर असर: इस तरीके का इस्तेमाल करने पर एक यूनिट की कोटे की कीमत लागू होती है.

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

अनुरोध

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

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
इस पैरामीटर का इस्तेमाल, सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है. पुष्टि किए गए उपयोगकर्ता के YouTube चैनल से जुड़े चैनल सेक्शन के फ़ीड को फिर से पाने के लिए, इस पैरामीटर की वैल्यू को true पर सेट करें.
वैकल्पिक पैरामीटर
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
इस संसाधन का ईटैग.
items[] list
अनुरोध की शर्तों को पूरा करने वाले Channelsections की सूची.

गड़बड़ियां

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

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

इसे आज़माएं!

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