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

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

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

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

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

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

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

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 संगठन (science डेवलपर के लिए झलक)	सिर्फ़ स्पेस
इस्तेमाल किए जा सकने वाले इवेंट	मैसेज सदस्यताएं प्रतिक्रियाएं स्पेस इवेंट के जिन टाइप के लिए सदस्यताएं बनाई जा सकती हैं उनकी सूची देखने के लिए, 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() तरीके को कॉल करता है. इससे, स्पेस में होने वाले सभी तरह के सदस्यता इवेंट की सदस्यता ली जा सकती है. सदस्यता बनाने के बाद, चैट ऐप्लिकेशन को सदस्यता से जुड़े इवेंट मिलने शुरू हो सकते हैं.

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

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

पैसे चुकाकर ली गई सदस्यता से जुड़े हाल ही के इवेंट के लिए क्वेरी

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

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

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

सीमाएं और डिलीवरी के तरीके

सामान्य सीमाएं

• सदस्यता से जुड़े इवेंट पाने के लिए, उपयोगकर्ता या चैट ऐप्लिकेशन को स्पेस का सदस्य होना चाहिए. अगर किसी व्यक्ति को Google ग्रुप के ज़रिए किसी स्पेस में जोड़ा गया है, अपडेट किया गया है या हटाया गया है, तो सदस्यता को सदस्यता से जुड़े उन इवेंट की सूचनाएं नहीं मिलती हैं. Google ग्रुप की सदस्यताएं कैसे काम करती हैं, यह जानने के लिए किसी स्पेस में Google ग्रुप जोड़ना लेख पढ़ें.

उपयोगकर्ता की सदस्यताएं

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

ग्राहक की सदस्यताएं

ग्राहक की सदस्यताओं के लिए, ये सीमाएं लागू होती हैं:

• Google Workspace संगठन के पास कम से कम एक Enterprise एसकेयू लाइसेंस होना चाहिए.
• कोई चैट ऐप्लिकेशन, Google Workspace के किसी संगठन के लिए सिर्फ़ एक ग्राहक सदस्यता बना सकता है. Google Workspace संगठन के पास, ग्राहक की ज़्यादा से ज़्यादा पांच सदस्यताएं हो सकती हैं. ये सदस्यताएं, अलग-अलग Chat ऐप्लिकेशन से बनाई जाती हैं.

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

• स्पेस इवेंट: ये इवेंट सिर्फ़ तब डिलीवर किए जाते हैं, जब इवेंट आपके Google Workspace संगठन के मैनेज किए जा रहे स्पेस में होता है.
• उपयोगकर्ता से जुड़े इवेंट: ये इवेंट सिर्फ़ तब डिलीवर किए जाते हैं, जब इवेंट आपके Google Workspace संगठन से जुड़े किसी उपयोगकर्ता के लिए होता है.

हालांकि, पैसे चुकाकर ली जाने वाली सदस्यता से जुड़े इवेंट के लिए, इन नियमों में छूट दी गई है. आपकी सदस्यता को, आपके संगठन और बाहरी संगठनों, दोनों के मैनेज किए जा रहे स्पेस से सदस्यता के इवेंट मिल सकते हैं. हालांकि, ये इवेंट कैसे डिलीवर किए जाएंगे, यह इस बात पर निर्भर करता है कि स्पेस को कौनसा संगठन मैनेज करता है:

आपके Google Workspace संगठन की ओर से मैनेज किए जाने वाले स्पेस

अगर Google Workspace संगठन के मैनेज किए जा रहे स्पेस में, सदस्यों की सूची में कोई बदलाव होता है, तो उसे स्पेस इवेंट के तौर पर डिलीवर किया जाता है.

स्पेस इवेंट के संसाधन के नाम के लिए, इस फ़ॉर्मैट का इस्तेमाल किया जाता है:

spaces/{spaceId}/spaceEvents/{spaceEventId}

बाहरी संगठनों से मैनेज किए जाने वाले स्पेस

अगर आपके Google Workspace संगठन से मैनेज किए जा रहे किसी उपयोगकर्ता की सदस्यता, किसी बाहरी संगठन से मैनेज किए जा रहे स्पेस में बदलती है, तो आपकी सदस्यता को यह इवेंट उपयोगकर्ता इवेंट के तौर पर मिलता है. जैसे, किसी बाहरी उपयोगकर्ता का बनाया गया डायरेक्ट मैसेज या बाहरी स्पेस.

उपयोगकर्ता इवेंट के संसाधन के नाम के लिए, इस फ़ॉर्मैट का इस्तेमाल किया जाता है:

users/{userId}/userEvents/{userEventId}

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

• Google Workspace Events API के बारे में खास जानकारी
• सदस्यता बनाना
• Google Chat स्पेस में होने वाले किसी इवेंट के बारे में जानकारी पाना
• Google Chat स्पेस में मौजूद इवेंट की सूची देखना