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

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

इस उदाहरण में, एक 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 स्पेस से इवेंट की सूची पाना लेख पढ़ें.

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

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

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

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

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

ग्राहक की सदस्यताएं (science डेवलपर के लिए झलक)

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

• Google Workspace संगठन के पास, कम से कम एक Enterprise SKU लाइसेंस होना चाहिए. ध्यान दें कि डेवलपर प्रीव्यू प्रोग्राम के स्टेज के दौरान, इस ज़रूरी शर्त को सख्ती से लागू नहीं किया जाएगा. हालांकि, आने वाले समय में इसे लागू किया जाएगा. इसके बारे में अलग से सूचना दी जाएगी.
• कोई Chat ऐप्लिकेशन, दिए गए 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 स्पेस से इवेंट की सूची पाना