Members: list

ध्यान दें: इस एंडपॉइंट का इस्तेमाल सिर्फ़ अलग-अलग क्रिएटर्स कर सकते हैं. वे इसका इस्तेमाल, अपने उस YouTube चैनल के लिए अनुरोध करने के लिए कर सकते हैं जिस पर पेड मेंबरशिप की सुविधा चालू है. ऐक्सेस का अनुरोध करने के लिए, अपने Google या YouTube प्रतिनिधि से संपर्क करें.

यह किसी चैनल के सदस्यों (पहले इन्हें "स्पॉन्सर" के नाम से जाना जाता था) की सूची बनाता है. एपीआई अनुरोध के लिए, चैनल के मालिक की अनुमति होनी चाहिए.

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

अनुरोध

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

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

अनुमति

इस अनुरोध के लिए, यहां बताए गए दायरे से अनुमति लेना ज़रूरी है:

स्कोप
https://www.googleapis.com/auth/youtube.channel-memberships.creator

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर ऐसी member संसाधन प्रॉपर्टी के बारे में बताता है जो एपीआई के रिस्पॉन्स में शामिल होंगी. पैरामीटर वैल्यू को snippet पर सेट करें.
वैकल्पिक पैरामीटर
mode string
mode पैरामीटर से पता चलता है कि एपीआई से मिले रिस्पॉन्स में किन सदस्यों को शामिल किया जाएगा. पैरामीटर वैल्यू को इनमें से किसी एक वैल्यू पर सेट करें:
  • all_current (डिफ़ॉल्ट) - सबसे नए से लेकर सबसे पुराने तक, मौजूदा सदस्यों की सूची बनाएं. जब इस वैल्यू का इस्तेमाल किया जाता है, तब एपीआई के रिस्पॉन्स में nextPageToken शामिल न होने पर, सूची के आखिर में पहुंच जाती है.
  • updates - सिर्फ़ उन सदस्यों की सूची बनाएं जो पिछले एपीआई कॉल के बाद शामिल हुए या अपग्रेड हुए. ध्यान दें कि पहला कॉल, अपडेट की नई स्ट्रीम शुरू करता है, लेकिन असल में कोई सदस्य वापस नहीं आता. पैसे चुकाकर ली जाने वाली सदस्यता से जुड़े अपडेट फिर से पाने के लिए, आपको अपने हिसाब से तय की गई फ़्रीक्वेंसी के हिसाब से nextPageToken का इस्तेमाल करके, एंडपॉइंट को पोल कराना होगा.

    ध्यान दें कि इस वैल्यू का इस्तेमाल किए जाने पर, एपीआई के रिस्पॉन्स में हमेशा nextPageToken शामिल होता है.
maxResults unsigned integer
maxResults पैरामीटर से यह तय होता है कि ज़्यादा से ज़्यादा कितने आइटम, नतीजे के सेट में दिखाए जाने चाहिए. स्वीकार किए जाने वाले मान 0 से 1000 तक हैं, जिसमें ये दोनों भी शामिल हैं. डिफ़ॉल्ट वैल्यू 5 है.
pageToken string
pageToken पैरामीटर, नतीजे के सेट में उस खास पेज की पहचान करता है जिसे दिखाया जाना चाहिए. यह टोकन खास तौर पर, ओरिजनल एपीआई अनुरोध के साथ इस्तेमाल किए गए mode के लिए होता है. इसलिए, किसी दूसरे मोड पर स्विच करने के लिए, किसी एक मोड से मिले पेज टोकन का इस्तेमाल नहीं किया जा सकता.
hasAccessToLevel string
hasAccessToLevel पैरामीटर की वैल्यू एक लेवल आईडी होता है. इससे पता चलता है कि नतीजे के सेट में शामिल सदस्यों के पास कम से कम कितना लेवल होना चाहिए.