इस गाइड में बताया गया है कि Google Chat API के Membership
संसाधन पर list()
तरीके का इस्तेमाल कैसे किया जाता है. इससे किसी स्पेस में मौजूद सदस्यों को पेज के हिसाब से व्यवस्थित किया जा सकता है. साथ ही, उन्हें स्पेस में सदस्यता के हिसाब से फ़िल्टर किया जा सकता है.
- ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ सदस्यताएं दिखाने पर, उन स्पेस की सदस्यताएं दिखती हैं जिनका ऐक्सेस Chat ऐप्लिकेशन के पास है. हालांकि, इसमें Chat ऐप्लिकेशन की सदस्यताएं शामिल नहीं होती हैं. इसमें खुद की सदस्यता भी शामिल नहीं होती है.
- उपयोगकर्ता की पुष्टि करके सदस्यताएं दिखाने की सुविधा, उन स्पेस में मौजूद सदस्यताओं को दिखाती है जिन्हें पुष्टि किए गए उपयोगकर्ता ने ऐक्सेस किया है.
- Google Workspace एडमिन के तौर पर, उपयोगकर्ता की पुष्टि करने के लिए एडमिन के विशेषाधिकार का इस्तेमाल करके, सदस्यताएं देखने की सुविधा मिलती है. इससे, आपको अपने Google Workspace संगठन के सभी स्पेस में मौजूद सदस्यताएं दिखती हैं.
Membership
संसाधन से पता चलता है कि किसी व्यक्ति या Google Chat ऐप्लिकेशन को स्पेस में शामिल होने का न्योता मिला है या नहीं. इससे यह भी पता चलता है कि वह स्पेस में शामिल है या नहीं.
ज़रूरी शर्तें
Node.js
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, Google Chat API चालू करें और उसे कॉन्फ़िगर करें. इसके लिए, Chat ऐप्लिकेशन का नाम, आइकॉन, और जानकारी दें.
- Node.js Cloud Client Library इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या Chat ऐप्लिकेशन के तौर पर.
- Google Chat स्पेस, जिसमें पुष्टि किया गया उपयोगकर्ता या कॉल करने वाला Chat ऐप्लिकेशन सदस्य हो. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Python
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, Google Chat API चालू करें और उसे कॉन्फ़िगर करें. इसके लिए, Chat ऐप्लिकेशन का नाम, आइकॉन, और जानकारी दें.
- Python Cloud Client Library इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या Chat ऐप्लिकेशन के तौर पर.
- Google Chat स्पेस, जिसमें पुष्टि किया गया उपयोगकर्ता या कॉल करने वाला Chat ऐप्लिकेशन सदस्य हो. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Java
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, Google Chat API चालू करें और उसे कॉन्फ़िगर करें. इसके लिए, Chat ऐप्लिकेशन का नाम, आइकॉन, और जानकारी दें.
- Java Cloud Client Library इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या Chat ऐप्लिकेशन के तौर पर.
- Google Chat स्पेस, जिसमें पुष्टि किया गया उपयोगकर्ता या कॉल करने वाला Chat ऐप्लिकेशन सदस्य हो. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Apps Script
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, Google Chat API चालू करें और उसे कॉन्फ़िगर करें. इसके लिए, Chat ऐप्लिकेशन का नाम, आइकॉन, और जानकारी दें.
- 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
: यह एक पेज टोकन है, जो list spaces को कॉल करने पर मिलता है. अगला पेज पाने के लिए, यह टोकन दें. पेज नंबर बदलते समय, फ़िल्टर की वैल्यू उस कॉल से मेल खानी चाहिए जिसने पेज टोकन दिया था. अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.filter
: क्वेरी फ़िल्टर. इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. क्वेरी की जानकारी के लिए,ListMembershipsRequest
रेफ़रंस देखें.
मिलते-जुलते विषय
- किसी उपयोगकर्ता या Chat ऐप्लिकेशन की सदस्यता के बारे में जानकारी पाना.
- किसी उपयोगकर्ता या Chat ऐप्लिकेशन को स्पेस में शामिल होने का न्योता भेजना या उसे स्पेस में जोड़ना.
- Google Chat स्पेस में किसी उपयोगकर्ता की सदस्यता अपडेट करना.
- किसी स्पेस से किसी उपयोगकर्ता या Chat ऐप्लिकेशन को हटाना.