Channels: list

ध्यान दें: YouTube की नीति में हुए बदलाव को दिखाने के लिए, channel संसाधन की statistics.subscriberCount प्रॉपर्टी की वैल्यू को अपडेट किया गया है. इस बदलाव से, सदस्यों की संख्या दिखने के तरीके पर असर पड़ता है. ज़्यादा जानकारी के लिए, कृपया बदलाव का इतिहास या YouTube का सहायता केंद्र देखें.

अनुरोध के मानदंड से मेल खाने वाले शून्य या ज़्यादा channel संसाधनों का संग्रह देता है.

कोटा असर: इस तरीके को कॉल करने पर कोटा लागत एक इकाई हो जाती है.

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

अनुरोध करें

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

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

अनुमति दें

channel रिसॉर्स के auditDetails अनुरोध को फिर से पाने के अनुरोध में, अनुमति वाला टोकन देना ज़रूरी है, जिसमें https://www.googleapis.com/auth/youtubepartner-channel-audit स्कोप शामिल हो. इसके अलावा, उस स्कोप का इस्तेमाल करने वाला कोई भी टोकन तब रद्द किया जाना चाहिए, जब एमसीएन चैनल को स्वीकार या अस्वीकार करने का फ़ैसला लेता है. इसके अलावा, टोकन जारी किए जाने की तारीख के दो हफ़्ते के अंदर उसे रद्द भी किया जा सकता है.

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part	string part पैरामीटर में एक या उससे ज़्यादा channel संसाधन प्रॉपर्टी की कॉमा-सेपरेटेड लिस्ट होती है, जिसमें एपीआई से मिलने वाला जवाब शामिल होगा. अगर पैरामीटर ऐसी प्रॉपर्टी की पहचान करता है जिसमें चाइल्ड प्रॉपर्टी हैं, तो चाइल्ड प्रॉपर्टी, रिस्पॉन्स में शामिल हो जाएंगी. उदाहरण के लिए, channel संसाधन में, contentDetails प्रॉपर्टी में uploads प्रॉपर्टी जैसी अन्य प्रॉपर्टी होती हैं. इसलिए, अगर आप part=contentDetails को सेट करते हैं, तो एपीआई रिस्पॉन्स में वे सभी नेस्ट की गई प्रॉपर्टी भी शामिल होंगी. नीचे दी गई सूची में part नाम शामिल हैं, जिन्हें आप पैरामीटर की वैल्यू में शामिल कर सकते हैं: auditDetails brandingSettings contentDetails contentOwnerDetails id localizations snippet statistics status topicDetails
फ़िल्टर (इनमें से किसी एक पैरामीटर के बारे में बताएं)
categoryId	string इस पैरामीटर को रोक दिया गया है. categoryId पैरामीटर में, YouTube गाइड की कैटगरी दी गई है. इसका इस्तेमाल, उस कैटगरी से जुड़े YouTube चैनलों का अनुरोध करने के लिए किया जा सकता है.
forUsername	string forUsername पैरामीटर, YouTube उपयोगकर्ता नाम की जानकारी देता है. इससे, उपयोगकर्ता नाम से जुड़े चैनल का अनुरोध किया जाता है.
id	string id पैरामीटर में, हटाए जा रहे संसाधनों के लिए YouTube चैनल आईडी की कॉमा-सेपरेटेड लिस्ट दी गई है. channel रिसॉर्स में, id प्रॉपर्टी से चैनल के YouTube चैनल आईडी की जानकारी मिलती है.
managedByMe	boolean इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. इस पैरामीटर की वैल्यू को true पर सेट करें, ताकि एपीआई को सिर्फ़ वही चैनल दिखाए जा सकें जिन्हें कॉन्टेंट के मालिक, onBehalfOfContentOwner पैरामीटर से तय करते हैं. उपयोगकर्ता की पुष्टि, कॉन्टेंट के मालिक के तौर पर जोड़े गए कॉन्टेंट मैनेजमेंट सिस्टम खाते के तौर पर होनी चाहिए. साथ ही, onBehalfOfContentOwner की जानकारी ज़रूर दी जानी चाहिए.
mine	boolean इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. इस पैरामीटर की वैल्यू को true पर सेट करें, ताकि एपीआई को सिर्फ़ पुष्टि किए गए उपयोगकर्ता के मालिकाना हक वाले चैनलों को दिखाने का निर्देश दिया जा सके.
ज़रूरी पैरामीटर
hl	string hl पैरामीटर, एपीआई को निर्देश देता है कि स्थानीय भाषा के हिसाब से बनाए गए रिसॉर्स मेटाडेटा को उस ऐप्लिकेशन की भाषा के हिसाब से बनाया जाए जिस पर YouTube की वेबसाइट काम करती है. पैरामीटर वैल्यू, भाषा का कोड होना चाहिए. इसे i18nLanguages.list तरीके से मिली सूची में शामिल किया जाना चाहिए. अगर स्थानीय भाषा में उपलब्ध संसाधन की जानकारी उसी भाषा में उपलब्ध है, तो संसाधन के snippet.localized ऑब्जेक्ट में स्थानीय भाषा के अनुसार वैल्यू शामिल होंगी. हालांकि, अगर स्थानीय भाषा में जानकारी नहीं दी गई है, तो snippet.localized ऑब्जेक्ट में संसाधन की डिफ़ॉल्ट भाषा में संसाधन की जानकारी दी जाएगी.
maxResults	unsigned integer maxResults पैरामीटर से पता चलता है कि नतीजों की सूची में कितने आइटम दिखाए जाने चाहिए. 0 से 50 तक के मान स्वीकार किए जाते हैं. डिफ़ॉल्ट वैल्यू 5 है.
onBehalfOfContentOwner	string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि के लिए, किसी YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान की गई है. यह उपयोगकर्ता, पैरामीटर वैल्यू में तय किए गए कॉन्टेंट के मालिक की तरफ़ से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें प्रबंधित करते हैं. इसकी मदद से कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं. साथ ही, अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल नहीं देने होंगे. जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से उपयोगकर्ता की पुष्टि होती है उसे YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए.
pageToken	string pageToken पैरामीटर, नतीजों के सेट में मौजूद उस खास पेज की पहचान करता है जिसे दिखाना है. एपीआई रिस्पॉन्स में, nextPageToken और prevPageToken प्रॉपर्टी उन दूसरे पेजों की पहचान करती है जिन्हें वापस लाया जा सकता है.

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

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

जवाब

अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:

{
  "kind": "youtube#channelListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    channel Resource
  ]
}

प्रॉपर्टी

इस टेबल में उन प्रॉपर्टी के बारे में बताया गया है जो इस रिसॉर्स में मौजूद हैं:

प्रॉपर्टी
kind	string इससे यह पता चलता है कि एपीआई संसाधन किस तरह का है. वैल्यू youtube#channelListResponse होगी.
etag	etag इस संसाधन का ऐट.
nextPageToken	string यह टोकन, pageTokenसेट की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे नतीजों के सेट में, अगला पेज फिर से मिल जाता है.
prevPageToken	string यह टोकन, pageToken पैरामीटर की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे, नतीजों के सेट में, पिछले पेज को वापस लाया जा सकता है. ध्यान दें कि अगर एपीआई से जुड़े अनुरोध के लिए managedByMe पैरामीटर को true पर सेट किया जाता है, तो इस प्रॉपर्टी को एपीआई रिस्पॉन्स में शामिल नहीं किया जाता है.
pageInfo	object pageInfo ऑब्जेक्ट, नतीजे के सेट के लिए पेजिंग जानकारी इकट्ठा करता है.
pageInfo.totalResults	integer नतीजों के सेट में कुल नतीजे.
pageInfo.resultsPerPage	integer एपीआई रिस्पॉन्स में शामिल किए गए नतीजों की संख्या.
items[]	list उन चैनलों की सूची जिनके लिए अनुरोध किया गया है.

गड़बड़ियां

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

गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
badRequest (400)	invalidCriteria	ज़्यादा से ज़्यादा इन फ़िल्टर में से किसी एक की जानकारी दी जा सकती है:id, categoryId, mine, managedByMe, forUsername. onBehalfOfContentOwner पैरामीटर से कॉन्टेंट के मालिक की पुष्टि होने पर, सिर्फ़ id या managedByMe की जानकारी दी जाएगी.
forbidden (403)	channelForbidden	id पैरामीटर से जुड़ा चैनल, अनुरोध के साथ काम नहीं करता या अनुरोध को सही तरीके से मंज़ूरी नहीं मिली है.
notFound (404)	categoryNotFound	categoryId पैरामीटर से पहचानी गई कैटगरी नहीं मिली. मान्य वैल्यू की सूची फिर से पाने के लिए, guideCategory.list तरीके का इस्तेमाल करें.
notFound (404)	channelNotFound	id पैरामीटर में बताया गया चैनल नहीं मिला.

इसे आज़माएं!

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