इस गाइड में, 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के बराबर नहींANDshowGroupsके बराबरtrueपर सेट करें.
ज़्यादा जानकारी और उदाहरणों के लिए, Google Workspace एडमिन के तौर पर Google Chat स्पेस मैनेज करना लेख पढ़ें.
पेज नंबर को पसंद के मुताबिक बनाएं या सूची को फ़िल्टर करें
सदस्यताओं की सूची बनाने के लिए, यहां दिए गए क्वेरी पैरामीटर पास करें. इससे, सूची में शामिल सदस्यताओं के पेज नंबर को पसंद के मुताबिक बनाया जा सकता है या उन्हें फ़िल्टर किया जा सकता है:
pageSize: सदस्यताएं दिखाने की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. यह जानकारी उपलब्ध न होने पर, ज़्यादा से ज़्यादा 100 स्पेस दिखाए जाते हैं. ज़्यादा से ज़्यादा 1,000 वैल्यू डाली जा सकती हैं. अगर वैल्यू 1,000 से ज़्यादा हैं, तो उन्हें अपने-आप 1,000 में बदल दिया जाता है.pageToken: यह एक पेज टोकन है, जो list spaces को कॉल करने पर मिलता है. अगला पेज पाने के लिए, यह टोकन दें. पेज नंबर बदलते समय, फ़िल्टर की वैल्यू उस कॉल से मेल खानी चाहिए जिसने पेज टोकन दिया है. अलग वैल्यू पास करने से, अनचाहे नतीजे मिल सकते हैं.filter: क्वेरी फ़िल्टर. इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. क्वेरी की जानकारी के साथ काम करने वाली सुविधाओं के बारे में जानने के लिए,ListMembershipsRequestरेफ़रंस देखें.
मिलते-जुलते विषय
- किसी उपयोगकर्ता या Chat ऐप्लिकेशन की सदस्यता के बारे में जानकारी पाएं.
- किसी उपयोगकर्ता या Chat ऐप्लिकेशन को स्पेस में शामिल होने का न्योता भेजना या उसे स्पेस में जोड़ना.
- Google Chat स्पेस में किसी उपयोगकर्ता की सदस्यता अपडेट करना.
- किसी स्पेस से किसी उपयोगकर्ता या Chat ऐप्लिकेशन को हटाना.