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