इस पेज पर, इस बारे में खास जानकारी दी गई है कि Google Workspace एडमिन, Google Chat API का इस्तेमाल करके अपने संगठन के सभी Google Chat स्पेस को कैसे मैनेज कर सकते हैं.
Chat स्पेस मैनेज करने के लिए, Google Workspace एडमिन, Google Admin console में स्पेस मैनेजमेंट टूल का इस्तेमाल कर सकते हैं या Google Chat API को कॉल कर सकते हैं. Chat API का इस्तेमाल करके, एडमिन ऐसे Google Chat ऐप्लिकेशन बना सकते हैं जो बड़े पैमाने पर स्पेस मैनेज करते हैं. साथ ही, सामान्य या बार-बार किए जाने वाले टास्क को ऑटोमेट करते हैं.
एडमिन, Chat API का इस्तेमाल करके क्या-क्या कर सकते हैं
एडमिन को एडमिन की जो भूमिकाएं असाइन की गई हैं उनके आधार पर, वह मैनेजमेंट से जुड़े काम कर सकता है.
Google Workspace एडमिन के तौर पर, Chat API की मदद से कई मैनेजमेंट टास्क किए जा सकते हैं. जैसे:
- बताई गई शर्तों के आधार पर स्पेस खोजें
- किसी स्पेस के सदस्यों की सूची
- किसी स्पेस में सदस्यों को जोड़ना और हटाना
- किसी सदस्य और स्पेस के बारे में जानकारी पाना
- किसी स्पेस को अपडेट करना या मिटाना
- किसी उपयोगकर्ता की सदस्यता अपडेट करना
Google Workspace एडमिन के तौर पर पुष्टि करने और अनुमति देने का तरीका
मैनेजमेंट से जुड़े टास्क के लिए Chat API का इस्तेमाल करते समय, एडमिन अनुरोधों की पुष्टि कर सकते हैं और उन्हें अनुमति दे सकते हैं. इसके लिए, वे एडमिन के विशेषाधिकार लागू कर सकते हैं या किसी ऐप्लिकेशन के सेवा खाते के लिए, पूरे डोमेन के लिए डेलिगेशन कॉन्फ़िगर कर सकते हैं.
इस टेबल में बताया गया है कि Chat API का इस्तेमाल करते समय, एडमिन किस तरह से पुष्टि कर सकते हैं.
| उपयोगकर्ता की पुष्टि करना | एपीआई के तरीके को कौन कॉल करता है | लोगों को Chat में क्या दिखता है |
|---|---|---|
| एडमिन के अधिकार | useAdminAccess=true वाला एडमिन
|
"संगठन के एडमिन ने [कार्रवाई] की." उदाहरण के लिए, "संगठन के एडमिन ने किरण बी को स्पेस मैनेजर बनाया." इससे एडमिन के उपयोगकर्ता नाम या यूज़र आईडी या Chat ऐप्लिकेशन के नाम की पहचान नहीं होती. |
| डोमेन के सभी उपयोगकर्ताओं के डेटा का ऐक्सेस दें | किसी उपयोगकर्ता की ओर से सेवा खाता |
"[User] ने [app name] के ज़रिए [an action] किया." उदाहरण के लिए, "साशा टी ने स्पेस का नाम बदलकर, रिलीज़ प्रोजेक्ट पर चर्चा किया." जिस उपयोगकर्ता के नाम पर सेवा काम कर रही है उसे कार्रवाई करने वाले व्यक्ति के तौर पर पहचाना जाता है. |
अपने संगठन के लिए Chat API का इस्तेमाल करना
इस सेक्शन में दिए गए उदाहरणों से पता चलता है कि एडमिन, Chat API का इस्तेमाल कैसे करते हैं. इससे वे अपने संगठन के स्पेस और सदस्यों को मैनेज कर पाते हैं. इसके लिए, उनके पास एडमिन के अधिकार होने चाहिए.
Chat API के इन तरीकों से, एडमिन को useAdminAccess=true के साथ खास अधिकार मिलते हैं.
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
उपयोगकर्ताओं की स्पेस की सदस्यताएं मैनेज करना
यहां दिए गए उदाहरणों से, Google Workspace एडमिन के तौर पर आपको यह पता चलेगा कि Chat API की मदद से, आपके संगठन के उपयोगकर्ताओं के लिए स्पेस की सदस्यता कैसे मैनेज की जा सकती है.
स्पेस में उपयोगकर्ताओं को जोड़ना
spaces.members.create() का इस्तेमाल करके, एडमिन किसी उपयोगकर्ता को संगठन के किसी भी स्पेस में जोड़ सकते हैं.
spaces.search() के साथ इस्तेमाल किया जाता है. इसकी मदद से एडमिन, खोज क्वेरी के आधार पर तय किए गए स्पेस के सेट में किसी उपयोगकर्ता को जोड़ सकते हैं. यह सुविधा, किसी संगठन में नए कर्मचारियों को शामिल करते समय काम आ सकती है. इससे एडमिन को, रोज़ाना की जाने वाली प्रोसेस को ऑटोमेट करने की सुविधा मिलती है.
उपयोगकर्ताओं को ढूंढना और उन्हें स्पेस से हटाना
spaces.members.get() का इस्तेमाल करके, एडमिन यह पता लगा सकते हैं कि कोई उपयोगकर्ता (संगठन के अंदर या बाहर का) संगठन के किसी स्पेस का सदस्य है या नहीं.
इस कुकी का इस्तेमाल spaces.search() के साथ किया जाता है. इससे एडमिन को उन सभी स्पेस का पता चलता है जिनमें उपयोगकर्ता सदस्य है. इसके बाद, वे उपयोगकर्ता को spaces.members.delete() वाले स्पेस से हटा सकते हैं.
यह सुविधा तब काम आ सकती है, जब कर्मचारी किसी संगठन में एक टीम से दूसरी टीम में जाते हैं या जब संगठन के कर्मचारी अब संगठन के साथ काम नहीं करते हैं. इससे एडमिन को, रोज़मर्रा की प्रोसेस को अपने-आप पूरा करने की सुविधा मिलती है.
उपयोगकर्ताओं को स्पेस मैनेजर की भूमिका देना
spaces.members.patch() का इस्तेमाल करके, एडमिन किसी स्पेस के सदस्यों को ROLE_MEMBER से ROLE_MANAGER की भूमिका पर प्रमोट कर सकते हैं.
एडमिन, सदस्यों को ROLE_MANAGER से ROLE_MEMBER में ले जाने के लिए, spaces.members.patch() का इस्तेमाल भी कर सकते हैं.
spaces.search() के साथ इस्तेमाल किया जाता है.
एडमिन ऐसे स्पेस ढूंढ सकते हैं जिनमें कोई मैनेजर नहीं है. इसके बाद, वे किसी मौजूदा सदस्य को spaces.members.patch() की मदद से ROLE_MANAGER के तौर पर प्रमोट कर सकते हैं.
किसी स्पेस में मौजूद, संगठन से बाहर के सदस्यों को ढूंढना
spaces.members.list() का इस्तेमाल करके, एडमिन किसी स्पेस में मौजूद सदस्यों की सूची पा सकते हैं. साथ ही, संगठन के People API या Directory API से उपयोगकर्ता की प्रोफ़ाइलें पा सकते हैं. इसके बाद, वे उन लोगों के लिए नतीजों को फ़िल्टर कर सकते हैं जो किसी बाहरी डोमेन या संगठन के सदस्य हैं.
ज़्यादा जानकारी के लिए, Chat उपयोगकर्ताओं की पहचान कैसे करता है लेख पढ़ें.
स्पेस का ऑडिट करना और उन्हें मैनेज करना
यहां कुछ ऐसे तरीके दिए गए हैं जिनसे Google Workspace एडमिन के तौर पर, Chat API की मदद से अपने संगठन के स्पेस की ऑडिट और उन्हें मैनेज किया जा सकता है.
इनऐक्टिव स्पेस ढूंढना और मिटाना
Chat के इस्तेमाल न किए गए स्पेस, स्टोरेज की ज़रूरी जगह घेर सकते हैं. साथ ही, यूज़र इंटरफ़ेस में गड़बड़ी पैदा कर सकते हैं. एडमिन, इनऐक्टिव स्पेस ढूंढने के लिए
spaces.search()
का इस्तेमाल कर सकते हैं. इसके बाद, उन्हें मिटाने के लिए
spaces.delete()
का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी और कोड का सैंपल देखने के लिए, इस्तेमाल नहीं किए जा रहे Chat स्पेस ढूंढना और उन्हें मिटाना लेख पढ़ें.
संगठन में मौजूद स्पेस की ऑडिट करना
spaces.search() का इस्तेमाल करके, एडमिन किसी संगठन के सभी स्पेस की सूची वापस पा सकते हैं. साथ ही, हर स्पेस की सेटिंग और मेटाडेटा के बारे में ज़्यादा जानकारी पा सकते हैं. जैसे, स्पेस बनाने की तारीख, आखिरी गतिविधि की तारीख, सदस्यों की संख्या, इतिहास की सेटिंग की स्थिति, और बाहरी मेहमानों को न्योता देने की सुविधा.
खोज के लिए तय की गई शर्तों के आधार पर, स्पेस की सूची एक्सपोर्ट करना
spaces.search() का इस्तेमाल करके, एडमिन उन स्पेस की सूची पा सकते हैं जो query में बताई गई शर्तों को पूरा करते हैं. साथ ही, वे नतीजों को CSV फ़ाइल में एक्सपोर्ट करके उनका विश्लेषण कर सकते हैं.
खोज की शर्तों के आधार पर, किसी स्पेस के सदस्यों को ढूंढना
spaces.members.list() का इस्तेमाल करके, एडमिन संगठन के किसी भी स्पेस के सदस्यों की सूची वापस पा सकते हैं. साथ ही, खास शर्तों के हिसाब से नतीजों का विश्लेषण कर सकते हैं.
किसी स्पेस के मैनेजर ढूंढना
spaces.members.list() का इस्तेमाल करके, एडमिन उस स्पेस के सदस्यों की सूची वापस पा सकते हैं जिसे MembershipState=ROLE_MANAGER के हिसाब से फ़िल्टर किया गया है.
अपने संगठन के सभी स्पेस मैनेजर को ढूंढने के लिए, सभी स्पेस में जाकर spaces.search() का इस्तेमाल करें. इसके बाद, सूची में मौजूद हर स्पेस के लिए, मैनेजर की जानकारी पाने के लिए spaces.members.list का इस्तेमाल करें.
मिलते-जुलते विषय
- एडमिन के अधिकारों का इस्तेमाल करके पुष्टि करना और अनुमति देना
- Google Workspace एडमिन के तौर पर, Google Chat API की मदद से Google Chat स्पेस खोजना और उन्हें मैनेज करना
spaces.search()तरीका