इस पेज पर, Google Workspace एडमिन के लिए यह जानकारी दी गई है कि वे अपने संगठन में Google Chat के स्पेस को मैनेज करने के लिए, Google Chat API का इस्तेमाल कैसे कर सकते हैं.
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 ऐप्लिकेशन के नाम की पहचान नहीं होती. |
| डोमेन के सभी उपयोगकर्ताओं के डेटा का ऐक्सेस | किसी उपयोगकर्ता की ओर से सेवा खाता |
"[उपयोगकर्ता] ने [ऐप्लिकेशन का नाम] का इस्तेमाल करके [कार्रवाई] की." उदाहरण के लिए, "साशा टी ने स्पेस का नाम बदलकर, रिलीज़ प्रोजेक्ट की चर्चा कर दिया." सेवा की मदद से किसी दूसरे व्यक्ति के नाम पर की गई कार्रवाई के लिए, उस व्यक्ति को ज़िम्मेदार माना जाता है. |
अपने संगठन के लिए 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() का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी और कोड का सैंपल पाने के लिए, इस्तेमाल में नहीं हैं ऐसे चैट स्पेस ढूंढना और मिटाना लेख पढ़ें.
संगठन में मौजूद स्पेस का ऑडिट करना
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()तरीका