इस गाइड में, Google Chat API के Membership
संसाधन पर list()
तरीके का इस्तेमाल करने का तरीका बताया गया है. इससे, किसी स्पेस में सदस्यों की सूची को पेज पर दिखाया जा सकता है और उसमें सदस्यताओं को फ़िल्टर किया जा सकता है.
- ऐप्लिकेशन की पुष्टि करने के बाद, सदस्यताओं की सूची में उन स्पेस की सदस्यताएं दिखती हैं जिनका ऐक्सेस Chat ऐप्लिकेशन के पास है. हालांकि, इसमें Chat ऐप्लिकेशन की सदस्यताएं शामिल नहीं होतीं.
- उपयोगकर्ता की पुष्टि करने के बाद, सदस्यताओं की सूची में उन स्पेस की सदस्यताएं दिखती हैं जिनका ऐक्सेस, पुष्टि किए गए उपयोगकर्ता के पास है.
- एडमिन के विशेषाधिकारों का इस्तेमाल करके, उपयोगकर्ता की पुष्टि करने के बाद, Google Workspace एडमिन के तौर पर सदस्यताओं की सूची बनाने पर, आपके Google Workspace संगठन के सभी स्पेस में सदस्यताओं की सूची दिखती है.
Membership
रिसॉर्स से पता चलता है कि किसी व्यक्ति या Google Chat ऐप्लिकेशन को स्पेस में शामिल होने का न्योता मिला है या नहीं. साथ ही, यह भी पता चलता है कि वह स्पेस में शामिल है या नहीं.
ज़रूरी शर्तें
Node.js
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Node.js क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Python
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Python क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई ऐसा स्पेस जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्य हो. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Java
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Java क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Apps Script
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- स्टैंडअलोन Apps Script प्रोजेक्ट बनाएं और ऐडवांस चैट सेवा चालू करें.
- इस गाइड में, आपको उपयोगकर्ता या ऐप्लिकेशन की पुष्टि में से किसी एक का इस्तेमाल करना होगा. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं. यह तरीका जानने के लिए, Google Chat ऐप्लिकेशन के तौर पर पुष्टि करना और अनुमति देना लेख पढ़ें.
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि कराने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
उपयोगकर्ता की पुष्टि करने की सुविधा की मदद से, स्पेस के सदस्यों की सूची बनाना
पुष्टि किए गए उपयोगकर्ता के पास जिस स्पेस का ऐक्सेस है उसमें उपयोगकर्ताओं, Google Groups, और Chat ऐप्लिकेशन की सूची बनाने के लिए, अपने अनुरोध में ये चीज़ें शामिल करें:
- उपयोगकर्ता की पुष्टि के लिए,
chat.memberships.readonly
याchat.memberships
अनुमति के दायरे की जानकारी दें. ListMemberships()
वाला तरीका कॉल करें.- Google ग्रुप की सूची देखने के लिए, क्वेरी पैरामीटर
showGroups
कोtrue
पर सेट करें.
यहां दिए गए उदाहरण में, Google ग्रुप, मानव, और ऐप्लिकेशन के उन सदस्यों की सूची दी गई है जो पुष्टि किए गए उपयोगकर्ता को दिखते हैं.
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, SPACE_NAME
को स्पेस के name
फ़ील्ड से मिले आईडी से बदलें. आईडी पाने के लिए, ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.
Google Chat API, दिए गए स्पेस में मौजूद Google ग्रुप, लोगों, और ऐप्लिकेशन के सदस्यों की सूची दिखाता है.
ऐप्लिकेशन से पुष्टि करने की सुविधा वाले स्पेस में सदस्यों की सूची देखना
पुष्टि किए गए ऐप्लिकेशन के पास जिस स्पेस का ऐक्सेस है उसमें उपयोगकर्ताओं और Chat ऐप्लिकेशन की सूची बनाने के लिए, अपने अनुरोध में यह जानकारी दें:
- ऐप्लिकेशन की पुष्टि के लिए,
chat.bot
अनुमति का दायरा तय करें. ListMemberships()
वाला तरीका कॉल करें.- Google ग्रुप की सूची देखने के लिए, क्वेरी पैरामीटर
showGroups
कोtrue
पर सेट करें.
यहां दिए गए उदाहरण में, Chat ऐप्लिकेशन में दिखने वाले स्पेस के उन सदस्यों की सूची दी गई है जो स्पेस मैनेजर नहीं हैं:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, SPACE_NAME
को स्पेस के name
फ़ील्ड से मिले आईडी से बदलें. ListSpaces()
वाला तरीका अपनाकर या स्पेस के यूआरएल से, आईडी पाया जा सकता है.
Google Chat API, दिए गए स्पेस के उन सदस्यों की सूची दिखाता है जो स्पेस मैनेजर नहीं हैं.
Google Workspace एडमिन के तौर पर सदस्यों की सूची बनाना
अगर आप Google Workspace एडमिन हैं, तो अपने Google Workspace संगठन के किसी भी स्पेस की सदस्यताओं की सूची देखने के लिए, ListMemberships()
तरीका अपनाएं. Chat API सिर्फ़ आपके संगठन के उपयोगकर्ताओं या Google ग्रुप की सदस्यता की जानकारी दिखाता है. इसमें, संगठन से बाहर के उपयोगकर्ताओं की सदस्यता की जानकारी शामिल नहीं होती. इसलिए, Chat ऐप्लिकेशन की सदस्यता की जानकारी नहीं दिखती.
Google Workspace एडमिन के तौर पर इस तरीके को कॉल करने के लिए, यह तरीका अपनाएं:
- उपयोगकर्ता की पुष्टि करने के तरीके का इस्तेमाल करके, उस तरीके को कॉल करें. साथ ही, ऐसा अनुमति का दायरा तय करें जिससे एडमिन के अधिकारों का इस्तेमाल करके, उस तरीके को कॉल किया जा सके.
- अपने अनुरोध में, ये क्वेरी पैरामीटर डालें:
useAdminAccess
कोtrue
पर सेट करें.- सिर्फ़ उपयोगकर्ताओं को दिखाने के लिए,
member.type
के लिएfilter
कोHUMAN
पर सेट करें. - उपयोगकर्ताओं और ग्रुप को दिखाने के लिए,
member.type
के लिएfilter
कोBOT
के बराबर औरAND
showGroups
कोtrue
के बराबर सेट करें.
ज़्यादा जानकारी और उदाहरणों के लिए, Google Workspace एडमिन के तौर पर Google Chat के स्पेस मैनेज करना लेख पढ़ें.
पेजेशन को पसंद के मुताबिक बनाना या सूची को फ़िल्टर करना
पैजेशन को पसंद के मुताबिक बनाने या सूची में शामिल सदस्यताओं को फ़िल्टर करने के लिए, सदस्यताओं की सूची देखने के लिए ये क्वेरी पैरामीटर पास करें:
pageSize
: सदस्यताओं की वह ज़्यादा से ज़्यादा संख्या जिन्हें लौटाना है. हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर कोई संख्या नहीं दी जाती है, तो ज़्यादा से ज़्यादा 100 स्पेस दिखाए जाते हैं. ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. 1,000 से ज़्यादा वैल्यू होने पर, वे अपने-आप 1,000 हो जाती हैं.pageToken
: स्पेस की सूची से जुड़े पिछले कॉल से मिला पेज टोकन. अगला पेज देखने के लिए, यह टोकन दें. पेजेशन करते समय, फ़िल्टर की वैल्यू उस कॉल से मेल खानी चाहिए जिसने पेज टोकन दिया है. कोई दूसरी वैल्यू पास करने पर, अनचाहे नतीजे मिल सकते हैं.filter
: क्वेरी फ़िल्टर. इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. काम करने वाली क्वेरी की जानकारी के लिए,ListMembershipsRequest
रेफ़रंस देखें.
मिलते-जुलते विषय
- किसी उपयोगकर्ता या Chat ऐप्लिकेशन की सदस्यता के बारे में जानकारी पाना.
- किसी उपयोगकर्ता या Chat ऐप्लिकेशन को स्पेस में शामिल होने का न्योता भेजना या उसे जोड़ना.
- Google Chat के स्पेस में किसी उपयोगकर्ता की सदस्यता की स्थिति अपडेट करना.
- स्पेस से किसी उपयोगकर्ता या Chat ऐप्लिकेशन को हटाना.