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

इस पेज पर बताया गया है कि 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 का संसाधन	इवेंट का टाइप
कोई उपयोगकर्ता, चैट स्पेस में मैसेज पोस्ट करता है	एक Message संसाधन बनाया गया है.	नया मैसेज
कोई उपयोगकर्ता, स्पेस मैनेजर बन जाता है.	Membership संसाधन अपडेट किया गया है.	पैसे चुकाकर ली गई सदस्यता को अपडेट किया गया
उपयोगकर्ता किसी मैसेज पर प्रतिक्रिया दे रहा है.	एक Reaction संसाधन बनाया गया है.	नई प्रतिक्रिया
कोई उपयोगकर्ता स्पेस छोड़ता है.	Membership संसाधन मिटा दिया गया है.	मिटाई गई सदस्यता

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

Google Chat से इवेंट पाना

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

• Google Workspace Events API का इस्तेमाल करके इवेंट की सदस्यता लें, ताकि उन्हें किसी भी समय इवेंट मिले.
• Chat API का इस्तेमाल करके, हाल ही के इवेंट के बारे में क्वेरी करें.

इस टेबल में, इवेंट के लिए क्वेरी करने या सदस्यता लेने की वजहों और अंतर के बारे में बताया गया है:

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

उदाहरण: स्पेस में सदस्यताओं से जुड़े इवेंट के बारे में क्वेरी करना या उनकी सदस्यता लेना

इस उदाहरण में, किसी चैट ऐप्लिकेशन को, चैट स्पेस के सदस्यों में हुए बदलावों के बारे में जानकारी चाहिए. स्पेस में, पैसे चुकाकर ली जाने वाली सदस्यता से जुड़ी ये गतिविधियां होती हैं:

• कोई उपयोगकर्ता स्पेस में शामिल होता है, जिससे Membership संसाधन बनता है और नए सदस्य इवेंट ट्रिगर होते हैं.
• कोई उपयोगकर्ता, स्पेस मैनेजर बन जाता है. इसके बाद, वह उपयोगकर्ता के लिए Membership संसाधन को अपडेट करता है और सदस्य के अपडेट किए गए इवेंट को ट्रिगर करता है.
• कोई उपयोगकर्ता इस स्पेस को छोड़ देता है. इससे उपयोगकर्ता के लिए, Membership संसाधन मिट जाता है और सदस्य के मिटाए गए इवेंट को ट्रिगर हो जाता है.

पैसे चुकाकर ली जाने वाली सदस्यता वाले इवेंट की सदस्यता लेना

रीयल टाइम में इवेंट की जानकारी पाने के लिए, Chat ऐप्लिकेशन, Google Workspace Events API subscriptions.create() के तरीके का इस्तेमाल करता है, ताकि सभी तरह के सदस्यता इवेंट के लिए स्पेस की सदस्यता ली जा सके. सदस्यता बनाने के बाद, चैट ऐप्लिकेशन को सदस्यता इवेंट मिलना शुरू हो सकता है.

दूसरी इमेज. किसी Chat ऐप्लिकेशन को, Google Workspace Events API का इस्तेमाल करके सदस्यता लेने पर सदस्यता इवेंट मिलता है.

दूसरी इमेज में, स्पेस में Chat ऐप्लिकेशन की चालू सदस्यता चालू है. इसलिए, स्पेस में पैसे चुकाकर ली जाने वाली सदस्यता में बदलाव होने पर, ऐप्लिकेशन को एक इवेंट मिलता है. इसके बाद, Chat ऐप्लिकेशन किसी भी गतिविधि को रीयल टाइम में प्रोसेस कर सकता है या उसका जवाब दे सकता है. जैसे, स्पेस में शामिल होने वाले सदस्य को निजी वेलकम मैसेज पोस्ट करना.

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

हाल ही के सदस्यता इवेंट के लिए क्वेरी

पैसे चुकाकर ली जाने वाली सदस्यता के इवेंट जैसे ही दिखते हैं, वैसे ही Chat ऐप्लिकेशन, Chat API को कॉल करके हाल ही के स्पेस इवेंट की सूची बना सकता है. ये इवेंट, सदस्यता की गतिविधि से जुड़े होते हैं.

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

तीसरी इमेज में दिखाया गया है कि चैट ऐप्लिकेशन, सदस्यता की सभी गतिविधियों के होने के बाद, Chat API spaces.spaceEvents.list() तरीके का इस्तेमाल करता है. इस तरीके में, सदस्यता के नए, अपडेट किए गए, और मिटाए गए इवेंट के लिए क्वेरी को फ़िल्टर किया जाता है. Chat API, spaceEvent से जुड़े रिसॉर्स की सूची दिखाता है. इन रिसॉर्स में, सदस्यता में हुए हर बदलाव के बारे में जानकारी होती है. इसके बाद, Chat ऐप्लिकेशन हाल की गतिविधि के हिसाब से प्रोसेस कर सकता है या उसका जवाब दे सकता है. उदाहरण के लिए, स्पेस में पिछले सात दिनों की सदस्यता गतिविधि की खास जानकारी वाला एक मैसेज पोस्ट करना.

Chat API का इस्तेमाल करके इवेंट के बारे में क्वेरी करने के लिए, Google Chat स्पेस के इवेंट की सूची बनाना देखें.

सीमाएं

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

मिलते-जुलते विषय

• Google Workspace Events API की खास जानकारी
• सदस्यता बनाना
• Google Chat पर मौजूद स्पेस में होने वाले इवेंट के बारे में जानकारी पाना
• Google Chat पर मौजूद किसी स्पेस के इवेंट की सूची बनाना
• इवेंट इस्तेमाल करने के उदाहरण देखने के लिए, Gemini AI Chat ऐप्लिकेशन की मदद से चैट पर होने वाली बातचीत के आधार पर सवालों के जवाब दें ट्यूटोरियल देखें या कोडलैब में मौजूद चैट ऐप्लिकेशन में, सभी को शामिल करने के लिए उपलब्ध सहायता सुविधा देखें. Gemini की मदद से Google Chat के लिए ऐप्लिकेशन बनाएं सेक्शन देखें.