Google Chat के इवेंट में हिस्सा लेना

इस पेज पर बताया गया है कि Google Chat के ऐप्लिकेशन, Google Chat में इवेंट कैसे रिसीव कर सकते हैं और उनके जवाब किस तरह दिए जा सकते हैं.

Google Chat इवेंट से Chat में कोई गतिविधि या बदलाव दिखता है, जैसे कि स्पेस में कोई नया मैसेज. आपका Chat ऐप्लिकेशन यह समझने के लिए इवेंट का इस्तेमाल कर सकता है कि क्या हुआ है. साथ ही, वह कार्रवाई कर सकता है या आपके उपयोगकर्ताओं के लिए काम का जवाब दे सकता है.

इवेंट इस्तेमाल करने के कुछ उदाहरण यहां दिए गए हैं:

• स्पेस में नए मैसेज मॉनिटर करें और उनका जवाब दें. जैसे, मुख्य शब्दों या वाक्यांशों की जांच करना.
• स्पेस में शामिल होने वाले उपयोगकर्ताओं को वेलकम मैसेज भेजें. इसमें स्पेस के दिशा-निर्देशों के बारे में बताया जा सकता है या Chat ऐप्लिकेशन का असरदार तरीक़े से इस्तेमाल करने के बारे में सलाह शेयर की जा सकती है.
• Chat पर की गई गतिविधि को ट्रैक करना और उसका विश्लेषण करना. उदाहरण के लिए, नए सदस्यों या सबसे ज़्यादा प्रतिक्रिया या जवाब पाने वाले मैसेज के बारे में हर महीने रिपोर्ट भेजना.
• मैसेज सेवा देने वाले सभी प्लैटफ़ॉर्म पर दर्शकों से बातचीत करना. उदाहरण के लिए, उपयोगकर्ता Chat को छोड़े बिना किसी दूसरे मैसेजिंग प्लैटफ़ॉर्म से उपयोगकर्ताओं के मैसेज भेज और पा सकते हैं.

इवेंट कैसे काम करते हैं

जब भी Google Chat में कुछ होता है, तो Google Chat API संसाधन बनाया जाता है, अपडेट किया जाता है या मिटा दिया जाता है. इवेंट से इस बात की जानकारी मिलती है कि गतिविधि कब हुई और Chat API के किस संसाधन पर असर पड़ा.

Chat, इवेंट को उनके टाइप के हिसाब से अलग-अलग कैटगरी में बांटता है. इवेंट टाइप की मदद से, अपनी ज़रूरत के हिसाब से जानकारी को फ़िल्टर और अनुरोध किया जा सकता है. साथ ही, मिलते-जुलते इवेंट को उसी तरह मैनेज किया जा सकता है.

इस टेबल में बताया गया है कि Chat में किसी गतिविधि का असर, Chat API से जुड़े संसाधन पर कैसे पड़ता है और आपके Chat ऐप्लिकेशन को मिलने वाले इवेंट किस तरह के हैं:

गतिविधि	Chat एपीआई संसाधन	इवेंट का टाइप
कोई उपयोगकर्ता, Chat स्पेस में मैसेज पोस्ट करता है	एक Message संसाधन बनाया गया.	नया मैसेज
कोई उपयोगकर्ता, स्पेस मैनेजर बन जाता है.	Membership संसाधन अपडेट किया गया.	अपडेट की गई सदस्यता
कोई उपयोगकर्ता किसी मैसेज पर प्रतिक्रिया देता है.	एक Reaction संसाधन बनाया गया.	नई प्रतिक्रिया
कोई उपयोगकर्ता स्पेस छोड़ता है.	Membership संसाधन मिटाया गया.	मिटाई गई सदस्यता

ध्यान दें: आपके Chat ऐप्लिकेशन को इंटरैक्शन इवेंट भी मिल सकते हैं. इन इवेंट की मदद से, उपयोगकर्ताओं से सीधे तौर पर इंटरैक्ट किया जा सकता है. जैसे, जब कोई उपयोगकर्ता किसी स्पेस में आपके Chat ऐप्लिकेशन को जोड़ता है या आपके Chat ऐप्लिकेशन का नाम टैग करता है. इंटरैक्शन इवेंट कॉन्फ़िगर करने और पाने के लिए, Google Chat ऐप्लिकेशन से होने वाले इंटरैक्शन की जानकारी पाना और उनका जवाब देना लेख पढ़ें.

Google Chat से इवेंट की जानकारी पाना

इवेंट पाने के लिए, आपका Chat ऐप्लिकेशन इनमें से कोई एक काम कर सकता है:

• Google Workspace Events API का इस्तेमाल करके इवेंट की सदस्यता लें, ताकि इवेंट होने पर आपको उनकी सूचना मिल सके.
• Chat एपीआई को कॉल करके इवेंट की क्वेरी करें.

Google Workspace Events API और Chat API, एक ही तरह के इवेंट के साथ काम करते हैं और डिलीवर करते हैं. यह समझने के लिए कि आपको इवेंट की सदस्यता लेनी चाहिए या इवेंट के लिए क्वेरी करनी चाहिए, यह टेबल देखें:

	इवेंट की सदस्यता लेना	इवेंट के लिए क्वेरी
इस्तेमाल के उदाहरण	रीयल टाइम में इवेंट प्रोसेस करें या उनके जवाब दें. उपयोगकर्ताओं की सदस्यता से जुड़ी गतिविधि पर नज़र रखें और मॉनिटर करने के लिए नई जगहें खोजें.	समय-समय पर या ट्रिगर की मदद से, इवेंट प्रोसेस करें या उनके जवाब दें. किसी सदस्यता (कुछ समय के लिए उपलब्ध न होने या सदस्यता बंद होने की वजह से) से छूटे हुए इवेंट फ़ेच करें.
API	Google Workspace Events API	Chat API
इवेंट का सोर्स	स्पेस और उपयोगकर्ता	सिर्फ़ स्पेस
इवेंट का फ़ॉर्मैट	Google Cloud Pub/Sub मैसेज, जिसे CloudEvent की खास जानकारी के हिसाब से फ़ॉर्मैट किया गया हो. ज़्यादा जानकारी के लिए, Google Workspace इवेंट का स्ट्रक्चर देखें.	Chat एपीआई संसाधन ( spaces.spaceEvent)
इवेंट डेटा	रिसॉर्स डेटा के साथ या उसके बिना, Base64 कोड में बदली गई स्ट्रिंग. पेलोड के उदाहरण के लिए, इवेंट डेटा देखें.	JSON पेलोड, जिसमें संसाधन डेटा शामिल है. कुछ तरह के इवेंट में, खास तरह के संसाधन फ़ील्ड ही शामिल होते हैं. पेलोड के उदाहरण के लिए, SpaceEvents रेफ़रंस दस्तावेज़ देखें.

Google Workspace Events API का इस्तेमाल करके सदस्यताएं बनाने के बारे में जानने के लिए, Google Workspace Events API का दस्तावेज़ देखें. Chat API का इस्तेमाल करके इवेंट के बारे में क्वेरी करने के लिए, ये गाइड देखें:

• Google Chat के स्पेस इवेंट के बारे में जानकारी पाना
• Google Chat स्पेस के इवेंट की सूची बनाना

सीमाएं

• उपयोगकर्ताओं की सदस्यताएं, डायरेक्ट मैसेज या बिना नाम वाली ग्रुप चैट (google.workspace.chat.membership.v1.created) में नए सदस्यों के बारे में इवेंट, पहला मैसेज पोस्ट होने के बाद ही ट्रिगर होते हैं.
• स्पेस के इतिहास में बदलाव करने से, अपडेट किए गए स्पेस के इवेंट ट्रिगर नहीं होते (इवेंट टाइप: google.workspace.chat.spaces.v1.updated).
• सदस्यता से जुड़े इवेंट की सूचनाएं पाने के लिए, यह ज़रूरी है कि उपयोगकर्ता स्पेस का सदस्य हो. अगर किसी उपयोगकर्ता को Google ग्रुप की मदद से, किसी स्पेस में सीधे तौर पर जोड़ा गया है, अपडेट किया गया है या हटाया गया है, तो सदस्यता को ऐसे इवेंट की जानकारी नहीं मिलेगी. यह समझने के लिए कि Google ग्रुप की सदस्यताएं कैसे काम करती हैं, स्पेस में Google ग्रुप जोड़ना लेख पढ़ें.