इस पेज पर बताया गया है कि Google Chat ऐप्लिकेशन, Google Chat में इवेंट कैसे पा सकते हैं और उनका जवाब कैसे दे सकते हैं.
Google Chat इवेंट, Chat में होने वाली किसी गतिविधि या बदलाव को दिखाता है. जैसे, किसी स्पेस में नया मैसेज. आपका Chat ऐप्लिकेशन, इवेंट का इस्तेमाल करके यह समझ सकता है कि क्या हुआ और उपयोगकर्ताओं के लिए काम की कार्रवाई कर सकता है या जवाब दे सकता है.
यहां इवेंट इस्तेमाल करने के कुछ उदाहरण दिए गए हैं:
- स्पेस में नए मैसेज पर नज़र रखना और उनका जवाब देना. जैसे, मुख्य शब्दों या वाक्यांशों की जांच करना.
- जब उपयोगकर्ता स्पेस में शामिल हों, तब उन्हें वेलकम मैसेज भेजें. इससे उन्हें स्पेस के दिशा-निर्देशों के बारे में बताया जा सकता है या Chat ऐप्लिकेशन का असरदार तरीके से इस्तेमाल करने के बारे में सलाह दी जा सकती है.
- चैट गतिविधि को ट्रैक और उसका विश्लेषण करना. उदाहरण के लिए, नए सदस्यों या उन मैसेज के बारे में हर महीने रिपोर्ट भेजने के लिए जिन पर सबसे ज़्यादा प्रतिक्रियाएं या जवाब मिलते हैं.
- अलग-अलग मैसेजिंग प्लैटफ़ॉर्म पर बातचीत करें. उदाहरण के लिए, उपयोगकर्ता Chat से बाहर निकले बिना, किसी दूसरे मैसेजिंग प्लैटफ़ॉर्म का इस्तेमाल करने वाले लोगों से मैसेज भेज और पा सकते हैं.
इवेंट कैसे काम करते हैं
Google Chat में कोई भी गतिविधि होने पर, Google Chat API संसाधन बनाया, अपडेट किया या मिटाया जाता है. Chat, इवेंट का इस्तेमाल करके आपके Chat ऐप्लिकेशन को यह जानकारी देता है कि किस तरह की गतिविधि हुई है और Chat API के किस संसाधन पर इसका असर पड़ा है.
Message संसाधन बनता है.
इसके बाद, Chat एक ऐसा इवेंट बनाता है जिसमें नए मैसेज का डेटा शामिल होता है.Chat, इवेंट को टाइप के हिसाब से कैटगरी में बांटता है. इवेंट टाइप की मदद से, सिर्फ़ अपनी ज़रूरत के हिसाब से जानकारी को फ़िल्टर किया जा सकता है और उसे पाया जा सकता है. साथ ही, एक जैसी गतिविधियों को एक ही तरीके से मैनेज किया जा सकता है.
यहां दी गई टेबल में बताया गया है कि Chat में की गई गतिविधि का असर, Chat API से जुड़ी किसी संसाधन पर कैसे पड़ता है. साथ ही, यह भी बताया गया है कि आपके Chat ऐप्लिकेशन को किस तरह का इवेंट मिलता है:
| गतिविधि | Chat API रिसॉर्स | इवेंट किस तरह का है |
|---|---|---|
| जब कोई उपयोगकर्ता, Chat स्पेस में कोई मैसेज पोस्ट करता है | Message संसाधन बनाया जाता है. |
नया मैसेज |
| कोई उपयोगकर्ता स्पेस मैनेजर बन जाता है. | Membership संसाधन अपडेट किया गया है. |
अपडेट की गई सदस्यता |
| जब कोई उपयोगकर्ता किसी मैसेज पर प्रतिक्रिया देता है. | Reaction संसाधन बनाया जाता है. |
नई प्रतिक्रिया |
| जब कोई उपयोगकर्ता किसी स्पेस को छोड़ देता है. | Membership संसाधन मिटाया गया है. |
सदस्यता मिटाई गई |
Google Chat से इवेंट पाना
इवेंट पाने के लिए, आपका Chat ऐप्लिकेशन इनमें से कोई एक काम कर सकता है:
- Google Workspace Events API का इस्तेमाल करके, इवेंट की सदस्यता लें. इससे आपको इवेंट होने पर उनकी सूचनाएं मिलेंगी.
- Chat API को कॉल करके, हाल ही के इवेंट के लिए क्वेरी करें.
यहां दी गई टेबल में, इवेंट के लिए क्वेरी करने या उनकी सदस्यता लेने के बीच का अंतर और इसकी वजहें बताई गई हैं:
| इवेंट के लिए सदस्यता लेना | इवेंट के लिए क्वेरी | |
|---|---|---|
| उपयोग के उदाहरण |
|
|
| एपीआई | Google Workspace Events API | Chat API |
| इवेंट का सोर्स | स्पेस और उपयोगकर्ता | सिर्फ़ स्पेस |
| इस्तेमाल किए जा सकने वाले इवेंट |
साथ काम करने वाले इवेंट टाइप की सूची देखने के लिए, Google Workspace Events API के दस्तावेज़ में सदस्यताएं बनाने के लिए इवेंट टाइप देखें. |
इवेंट टाइप की सूची देखने के लिए, Chat API के रेफ़रंस दस्तावेज़ में spaceEvents संसाधन देखें.
|
| इवेंट का फ़ॉर्मैट | CloudEvent स्पेसिफ़िकेशन के मुताबिक फ़ॉर्मैट किया गया Google Cloud Pub/Sub मैसेज. ज़्यादा जानकारी के लिए, Google Workspace इवेंट का स्ट्रक्चर देखें. |
Chat API का संसाधन
(
spaces.spaceEvent)
|
| इवेंट का डेटा | Base64 में कोड में बदली गई स्ट्रिंग, जिसमें संसाधन का डेटा शामिल हो भी सकता है और नहीं भी. उदाहरण के लिए पेलोड देखने के लिए, इवेंट डेटा देखें. | JSON पेलोड, जिसमें संसाधन का डेटा शामिल होता है. कुछ इवेंट टाइप में सिर्फ़ कुछ संसाधन फ़ील्ड शामिल होते हैं. उदाहरण के लिए पेलोड देखने के लिए, रेफ़रंस दस्तावेज़ देखें. |
उदाहरण: किसी स्पेस में सदस्यता से जुड़े इवेंट के बारे में क्वेरी करना या उनकी सदस्यता लेना
इस उदाहरण में, Chat ऐप्लिकेशन को Chat स्पेस के सदस्यों में हुए बदलावों के बारे में सूचनाएं पाने की अनुमति चाहिए. स्पेस में, सदस्यता से जुड़ी ये गतिविधियां होती हैं:
- जब कोई उपयोगकर्ता स्पेस में शामिल होता है, तब
Membershipसंसाधन बनता है और नए सदस्य का इवेंट ट्रिगर होता है. - जब कोई उपयोगकर्ता स्पेस मैनेजर बनता है, तब उसके लिए
Membershipसंसाधन अपडेट हो जाता है. साथ ही, सदस्य के अपडेट होने का इवेंट ट्रिगर हो जाता है. - जब कोई उपयोगकर्ता स्पेस छोड़ता है, तो उसके लिए
Membershipसंसाधन मिट जाता है. साथ ही, सदस्य के मिटाए जाने का इवेंट ट्रिगर होता है.
पैसे चुकाकर ली जाने वाली सदस्यता से जुड़े इवेंट के लिए सदस्यता लेना
रीयल टाइम में इवेंट पाने के लिए, Chat ऐप्लिकेशन, Google Workspace Events API subscriptions.create() तरीके का इस्तेमाल करता है. इससे, सदस्यता से जुड़े सभी तरह के इवेंट के लिए स्पेस को सब्सक्राइब किया जा सकता है. सदस्यता बनाने के बाद, Chat ऐप्लिकेशन को सदस्यता से जुड़े इवेंट मिलने शुरू हो सकते हैं.
दूसरी इमेज में दिखाया गया है कि Chat ऐप्लिकेशन के पास स्पेस की चालू सदस्यता है. इसलिए, जब भी स्पेस में सदस्यता में बदलाव होता है, तो ऐप्लिकेशन को इवेंट मिलता है. इसके बाद, Chat ऐप्लिकेशन इन गतिविधियों को रीयल टाइम में प्रोसेस कर सकता है या इनका जवाब दे सकता है. जैसे, स्पेस में शामिल होने वाले सदस्य को निजी तौर पर स्वागत मैसेज पोस्ट करना.
Google Workspace Events API का इस्तेमाल करके सदस्यताएं बनाने के बारे में जानने के लिए, Google Workspace Events API का दस्तावेज़ देखें.
हाल ही में हुई सदस्यता से जुड़ी घटनाओं के लिए क्वेरी
सदस्यता से जुड़े इवेंट होने पर सूचना पाने के बजाय, Chat ऐप्लिकेशन Chat API को कॉल करके, सदस्यता से जुड़ी गतिविधि के हाल ही के स्पेस इवेंट की सूची बना सकता है.
तीसरी इमेज में, सदस्यता से जुड़ी सभी गतिविधियां पूरी होने के बाद, Chat ऐप्लिकेशन, Chat API
spaces.spaceEvents.list()
मेथड को कॉल करता है. साथ ही, सदस्यता से जुड़े नए, अपडेट किए गए, और मिटाए गए इवेंट के लिए क्वेरी को फ़िल्टर करता है. Chat API, सदस्यता में हुए हर बदलाव को दिखाने वाले spaceEvent संसाधनों की सूची दिखाता है.
इसके बाद, Chat ऐप्लिकेशन हाल ही की गतिविधि के आधार पर कार्रवाई कर सकता है या जवाब दे सकता है. जैसे, पिछले सात दिनों में स्पेस में सदस्यों की गतिविधि की खास जानकारी देने वाला मैसेज हर हफ़्ते पोस्ट करना.
Chat API का इस्तेमाल करके इवेंट के बारे में क्वेरी करने के लिए, Google Chat स्पेस से इवेंट की सूची बनाना लेख पढ़ें.
सीमाएं
-
उपयोगकर्ताओं की सदस्यताओं के लिए, डायरेक्ट मैसेज या बिना नाम वाली ग्रुप चैट (
google.workspace.chat.membership.v1.created) में नए सदस्यों के बारे में इवेंट, सिर्फ़ पहला मैसेज पोस्ट होने के बाद ट्रिगर होते हैं. - सदस्यता से जुड़े इवेंट पाने के लिए, उपयोगकर्ता या Chat ऐप्लिकेशन को स्पेस का सदस्य होना चाहिए. अगर उन्हें Google ग्रुप के ज़रिए स्पेस में जोड़ा गया है, अपडेट किया गया है या हटाया गया है, तो सदस्यता को इन इवेंट की सूचना नहीं मिलती. Google ग्रुप की सदस्यताएं कैसे काम करती हैं, यह जानने के लिए किसी स्पेस में Google ग्रुप जोड़ना लेख पढ़ें.
मिलते-जुलते विषय
- Google Workspace Events API के बारे में खास जानकारी
- सदस्यता बनाना
- Google Chat स्पेस में होने वाले किसी इवेंट के बारे में जानकारी पाना
- Google Chat स्पेस से इवेंट की सूची पाना