एपीआई अनुरोध की शर्तों के मुताबिक, channelSection
संसाधनों की सूची दिखाता है.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत एक इकाई हो जाती है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध करें
एचटीटीपी अनुरोध
GET https://www.googleapis.com/youtube/v3/channelSections
पैरामीटर
इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string part पैरामीटर में एक या उससे ज़्यादा channelSection संसाधन प्रॉपर्टी की कॉमा-सेपरेटेड लिस्ट होती है, जिसमें एपीआई से मिलने वाला जवाब शामिल होगा.अगर पैरामीटर ऐसी प्रॉपर्टी की पहचान करता है जिसमें चाइल्ड प्रॉपर्टी हैं, तो चाइल्ड प्रॉपर्टी, रिस्पॉन्स में शामिल हो जाएंगी. उदाहरण के लिए, channelSection रिसॉर्स में, snippet प्रॉपर्टी में अन्य प्रॉपर्टी शामिल होती हैं, जैसे कि सेक्शन के लिए डिसप्ले टाइटल. part=snippet को सेट करने पर, एपीआई रिस्पॉन्स में वे सभी नेस्ट की गई प्रॉपर्टी भी शामिल होंगी.नीचे दी गई सूची में part नाम शामिल हैं, जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
|
|
फ़िल्टर (इनमें से किसी एक पैरामीटर के बारे में बताएं) | ||
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 चैनल के उन सेक्शन की सूची जिनके लिए अनुरोध किया गया है. |
गड़बड़ियां
इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो इस तरीके से कॉल करने पर एपीआई मिल सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
forbidden (403) |
channelSectionForbidden |
अनुरोध करने वाले को अनुरोध किए गए चैनल सेक्शन को ऐक्सेस करने की अनुमति नहीं है. |
invalidValue (400) |
idInvalid |
अनुरोध में मौजूद चैनल सेक्शन का आईडी अमान्य है. |
invalidValue (400) |
invalidCriteria |
फ़िल्टर की शर्तें गलत होने की वजह से अनुरोध पूरा नहीं हो सका. |
notFound (404) |
channelNotFound |
अनुरोध से जुड़ा चैनल नहीं मिला. |
notFound (404) |
channelSectionNotFound |
अनुरोध से जुड़ा चैनल सेक्शन नहीं मिला. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.