इस पेज पर, Google Chat के उन इवेंट के बारे में बताया गया है जो Google Chat ऐप्लिकेशन में मौजूद होते हैं Google Workspace Events API का इस्तेमाल करके सदस्यता ली जा सकती है. जब आप यह तय कर लें कि किस तरह के इवेंट की ज़रूरत है, किसी इवेंट को सदस्यता पाना शुरू करने के लिए Google Chat के इवेंट.
इवेंट की सदस्यता लेने के अलावा, इवेंट के लिए कॉल करके भी क्वेरी की जा सकती है Chat API का इस्तेमाल करें. Chat API को कॉल करने से आपको समय-समय पर इवेंट दिखते रहें या हो सकता है कि कुछ समय के लिए उपलब्ध न होने की वजह से सदस्यता न मिल पाए. सीखने में Chat इवेंट पाने और उनका जवाब देने के तरीकों के बारे में जानने के लिए, इसमें Google Chat के इवेंट का इस्तेमाल करना चैट का दस्तावेज़.
Chat के साथ काम करने वाले इवेंट
Google Workspace की सदस्यता से आपको इवेंट से जुड़ी जानकारी मिलती है इस तरह के बदलाव होंगे:
- नए, अपडेट किए गए या मिटाए गए मैसेज अंतरिक्ष में.
- नई या हटाई गई प्रतिक्रियाएं किसी मैसेज को कॉपी करने के लिए प्रोत्साहित कर रहा है.
- नए, अपडेट किए गए या हटाए गए सदस्य अंतरिक्ष में.
- स्पेस में किए गए बदलाव जिसकी आपने सदस्यता ली है. जैसे, स्पेस का अपडेट किया गया नाम या ब्यौरा.
इवेंट पर नज़र रखने के लिए संसाधन
इवेंट पाने के लिए, आप चैट पर नज़र रखने के लिए, इसे सदस्यता का टारगेट रिसॉर्स कहा जाता है.
Google Workspace Events API इन टारगेट संसाधनों के साथ काम करता है चैट के लिए:
टारगेट संसाधन | फ़ॉर्मैट | सीमाएं |
---|---|---|
स्पेस |
जहां SPACE
Chat API |
Chat का इस्तेमाल करने वाले जिस उपयोगकर्ता ने सदस्यता की अनुमति दी है उसे यह ज़रूरी है Google Workspace या Google के ज़रिए स्पेस का सदस्य बन सकता है खाता. |
उपयोगकर्ता के लिए सभी स्पेस |
|
सदस्यता में, उपयोगकर्ता को सिर्फ़ उन स्पेस के इवेंट मिलते हैं सदस्यता के लिए, उनके Google Workspace या Google खाते का इस्तेमाल करता है. |
उपयोगकर्ता |
जहां USER
Chat API |
सदस्यता में, उस उपयोगकर्ता के सिर्फ़ ऐसे इवेंट शामिल होते हैं ने सदस्यता को अनुमति दी है. कोई उपयोगकर्ता इस पर सदस्यता को अनुमति नहीं दे सकता शेयर किया जा सकता है. |
सदस्यताएं बनाने के लिए इवेंट के टाइप
सदस्यता बनाने के बाद,
eventTypes[]
फ़ील्ड का इस्तेमाल करें. इवेंट के टाइप ये हैं
को CloudEvent की खास बातों के मुताबिक फ़ॉर्मैट किया जाता है, जैसे कि
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
.
उदाहरण के लिए, किसी Chat में शामिल होने वाले उपयोगकर्ताओं के इवेंट पाने के लिए
स्पेस, आप स्पेस को लक्ष्य संसाधन के रूप में तय करते हैं और इवेंट प्रकार
google.workspace.chat.membership.v1.created
. किसी खास इवेंट की जानकारी पाने के लिए
किसी स्पेस में शामिल होने के लिए, आप उपयोगकर्ता को लक्ष्य संसाधन के रूप में तय करते हैं, और
google.workspace.chat.membership.v1.created
के रूप में इवेंट प्रकार. इस बारे में ज़्यादा जानने के लिए
इवेंट कैसे काम करते हैं, Google Workspace का स्ट्रक्चर देखें
इवेंट में बदल सकते हैं.
इस टेबल में बताया गया है कि सदस्यताओं के लिए, किस तरह के इवेंट काम करते हैं साथ ही, सदस्यताएँ लेने की सुविधा भी देती है. इन अपवादों के बारे में जानने के लिए इवेंट को ट्रिगर करने वाली चीज़ें जानने के लिए, सीमाएं देखें.
इवेंट का टाइप | फ़ॉर्मैट | संसाधन का डेटा | ||
---|---|---|---|---|
स्पेस की सदस्यताएं | ||||
एक मैसेज पोस्ट किया गया. |
|
|
||
मैसेज अपडेट किया गया. |
|
|
||
एक मैसेज मिटाया गया. |
|
|
||
इसके बाद, एक प्रतिक्रिया तैयार हो जाएगी. |
|
|
||
प्रतिक्रिया मिटा दी गई है. |
|
|
||
स्पेस में एक सदस्य को जोड़ दिया गया है. |
|
|
||
स्पेस में किसी सदस्य को अपडेट किया गया है. |
|
|
||
एक सदस्य को स्पेस से हटा दिया गया है. |
|
|
||
स्पेस को अपडेट किया गया है. |
|
|
||
स्पेस को मिटा दिया गया है. |
|
|
||
उपयोगकर्ताओं की सदस्यताएं | ||||
उपयोगकर्ता, स्पेस का सदस्य बन जाता है.
सभी नए सदस्य इवेंट ट्रिगर नहीं करते. ज़्यादा जानकारी के लिए, सीमाएं देखें |
|
|
||
स्पेस में उपयोगकर्ता की सदस्यता अपडेट हो जाती है. |
|
|
||
स्पेस के सदस्य को सीधे तौर पर स्पेस से हटा दिया जाता है. |
|
|
बैच इवेंट टाइप (सिर्फ़ आउटपुट)
आपने जिन इवेंट टाइप की सदस्यता ली है उन्हें पाने के अलावा, Chat ऐप्लिकेशन को बैच इवेंट की जानकारी भी मिल सकती है. बैच इवेंट एक ऐसा इवेंट है जो एक ही तरह के कई इवेंट को दिखाता है, जो समय की पाबंदी है. बैच इवेंट के पेलोड में सभी बदलावों की सूची शामिल है संसाधन.
उदाहरण के लिए, अगर कोई उपयोगकर्ता किसी स्पेस में एक साथ 20 उपयोगकर्ताओं को जोड़ता है, तो
Chat ऐप्लिकेशन को बैच इवेंट मिल सकता है
(google.workspace.chat.membership.v1.batchCreated
). इवेंट पेलोड में यह शामिल है
उन सभी नए Membership
संसाधनों की सूची जिन्हें उपयोगकर्ता ने तब बनाया था, जब
सदस्यों को स्पेस में जोड़ा.
आपको सदस्यता लिए गए हर तरह के इवेंट के लिए बैच इवेंट मिलता है, इसलिए
आपको सदस्यता बनाते समय बैच इवेंट बताने की ज़रूरत नहीं है. इसके लिए
उदाहरण के लिए, अगर आपको किसी सदस्य को
(google.workspace.chat.reaction.v1.created
), आपका
बैच पाने के लिए Chat ऐप्लिकेशन अपने-आप कॉन्फ़िगर हो जाता है
प्रतिक्रिया वाले इवेंट (google.workspace.chat.reaction.v1.batchCreated
).
नीचे दी गई टेबल में, सदस्यता के लिए संभावित बैच इवेंट दिखाए गए हैं:
बैच इवेंट का टाइप | फ़ॉर्मैट |
---|---|
कई मैसेज पोस्ट किए गए हैं. |
|
एक से ज़्यादा मैसेज अपडेट किए गए हैं. |
|
एक से ज़्यादा मैसेज मिटा दिए जाते हैं. |
|
कई प्रतिक्रियाएं जनरेट हो जाती हैं. |
|
कई प्रतिक्रियाएं मिटा दी गई हैं. |
|
जिस स्पेस की सदस्यता ली गई है उसमें एक से ज़्यादा सदस्य जोड़ दिए गए हैं या सदस्यता लेने वाले उपयोगकर्ता को एक से ज़्यादा स्पेस में जोड़ दिया गया है. |
|
सदस्यता वाली जगह पर या उस उपयोगकर्ता के लिए, एक से ज़्यादा सदस्यताएं अपडेट हो जाती हैं जिसकी सदस्यता ली गई है. |
|
जिस स्पेस की सदस्यता ली गई है उससे एक से ज़्यादा सदस्यों को हटा दिया जाता है. इसके अलावा, उन स्पेस से भी हटा दिया जाता है जिनकी सदस्यता ली गई है. |
|
स्पेस में कई अपडेट हैं. |
|
इवेंट का डेटा
इस सेक्शन में, इवेंट डेटा के बारे में बताया गया है. साथ ही, इवेंट के पेलोड के उदाहरण दिए गए हैं चैट करें.
जब आपकी Google Workspace सदस्यता को कोई इवेंट
चैट,
data
फ़ील्ड में इवेंट का पेलोड होता है. इस पेलोड में
Google Workspace के संसाधन में बदलाव हुआ है. उदाहरण के लिए, यदि आपने
किसी स्पेस में पैसे चुकाकर ली जाने वाली सदस्यता के इवेंट होते हैं, तो इन इवेंट के पेलोड में जानकारी होती है
के बारे में
spaces.membership
संसाधन बदल गए.
इवेंट पेलोड में संसाधन का डेटा
सदस्यता बनाते समय, यह तय किया जा सकता है कि पेलोड को उसमें संसाधन का ब्यौरा या सिर्फ़ संसाधन का नाम शामिल होना चाहिए. इसके लिए उदाहरण के लिए, अगर आपको किसी Chat में मौजूद सदस्यों से जुड़े इवेंट चाहिए स्पेस हो, तो आपके पास यह तय करने की सुविधा होती है कि आपको सदस्यता संसाधन के कौनसे फ़ील्ड चाहिए इवेंट पेलोड में.
नीचे दी गई टेबल में, सदस्यता के लिए JSON पेलोड के उदाहरण दिए गए हैं
चैट स्पेस spaces/AAAABBBBBB
. हर उस इवेंट के लिए जिसे
सदस्यता मिलने के बाद, पेलोड इवेंट के data
फ़ील्ड में दिखता है:
उदाहरण | इवेंट का टाइप | JSON पेलोड |
---|---|---|
किसी व्यक्ति ने स्पेस में "नमस्ते वर्ल्ड" मैसेज पोस्ट किया है. |
|
संसाधन का डेटा शामिल है
{ "message": { "name": "spaces/AAAABBBBBB/messages/CCCCCCCCC.DDDDDDDDD", "sender": { "name": "users/1234567890987654321", "type": "HUMAN" }, "createTime": "2023-09-07T21:37:36.260127Z", "text": "Hello world", "thread": { "name": "spaces/AAAABBBBBB/threads/EEEEEEEEEEEE" }, "space": { "name": "spaces/AAAABBBBBB" }, "argumentText": "Hello world" } } संसाधन डेटा शामिल नहीं है
{ "message": { "name": "spaces/AAAABBBBBB/messages/CCCCCCCCC.DDDDDDDDD" } } |
कोई उपयोगकर्ता, स्पेस मैनेजर बन जाता है. |
|
संसाधन का डेटा शामिल है
{ "membership": { "name": "spaces/AAAABBBBBB/members/1234567890987654321", "state": "JOINED", "member": { "name": "users/1234567890987654321", "type": "HUMAN" }, "createTime": "1970-01-01T00:00:00Z", "role": "ROLE_MANAGER" } } संसाधन डेटा शामिल नहीं है
{ "membership": { "name": "spaces/AAAABBBBBB/members/1234567890987654321" } } |
इस इमेज में दिखाया गया है कि कोई उपयोगकर्ता, स्पेस के ब्यौरे को "Simpal Labs की सेल्स टीम" में अपडेट करता है. | google.workspace.chat.space.v1.updated |
संसाधन का डेटा शामिल है
{ "space": { "name": "spaces/AAAABBBBBB", "displayName": "Cymbal Sales", "spaceThreadingState": "THREADED_MESSAGES", "spaceType": "SPACE", "spaceDetails": { "description": "Sales team for Cymbal Labs." }, "spaceHistoryState": "HISTORY_ON" } } संसाधन का डेटा शामिल नहीं है
{ "space": { "name": "spaces/AAAABBBBBB" } } |
स्पेस में एक ही समय पर दो Chat उपयोगकर्ताओं को जोड़ा गया. | google.workspace.chat.membership.v1.batchCreated |
संसाधन का डेटा शामिल है
{ "memberships": [ { "membership": { "name": "spaces/AAAABBBBBB/members/1234567890987654321", "state": "JOINED", "member": { "name": "users/1234567890987654321", "type": "HUMAN" }, "createTime": "1970-01-01T00:00:00Z", "role": "ROLE_MEMBER" } }, { "membership": { "name": "spaces/AAAABBBBBB/members/987654321234567890", "state": "JOINED", "member": { "name": "users/987654321234567890", "type": "HUMAN" }, "createTime": "1970-01-01T00:00:00Z", "role": "ROLE_MEMBER" } } ] } संसाधन डेटा शामिल नहीं है
{ "memberships": [ { "membership": { "name": "spaces/AAAABBBBBB/members/1234567890987654321" } }, { "membership": { "name": "spaces/AAAABBBBBB/members/98765432123456789019" } } ] } |
कोई उपयोगकर्ता, 😊 इमोजी का इस्तेमाल करके मैसेज पर प्रतिक्रिया देता है. | google.workspace.chat.reaction.v1.created |
संसाधन का डेटा शामिल है
{ "reaction": { "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222", "user": { "name": "users/1234567890987654321", "type": "HUMAN" }, "emoji": { "unicode": "😊" } } } संसाधन का डेटा हटा देता है
{ "reaction": { "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222" } } |
उपयोगकर्ता, 😊 इमोजी और APNS इमोजी के ज़रिए मैसेज पर प्रतिक्रिया देते हैं. | google.workspace.chat.reaction.v1.batchCreated |
संसाधन का डेटा शामिल है
{ "reactions": [ { "reaction": { "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222", "user": { "name": "users/1234567890987654321", "type": "HUMAN" }, "emoji": { "unicode": "😊" } } }, { "reaction": { "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/3333333333333333.444444444444444", "user": { "name": "users/98765431234564321", "type": "HUMAN" }, "emoji": { "unicode": "😸" } } } ] } संसाधन का डेटा हटा देता है
{ "reactions": [ { "reaction": { "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/1111111111111111.222222222222222" }, "reaction": { "name": "spaces/AAAABBBBBB/messages/123456789.123456789/reactions/3333333333333333.444444444444444", } } ] } |
सीमाएं
-
उपयोगकर्ताओं की सदस्यताओं, डायरेक्ट मैसेज या बिना नाम वाली ग्रुप चैट में नए सदस्यों के बारे में इवेंट (
google.workspace.chat.membership.v1.created
), सिर्फ़ तब ट्रिगर होता है, जब पहला मैसेज पोस्ट किया जाता है. - पैसे चुकाकर ली जाने वाली सदस्यता के इवेंट पाने के लिए, यह ज़रूरी है कि उपयोगकर्ता, स्पेस का सदस्य हो. अगर किसी उपयोगकर्ता को जोड़ा गया था, अगर किसी स्पेस को Google ग्रुप के ज़रिए अपडेट किया जाता है या उससे किसी और तरीके से हटाया जाता है, तो भी सदस्यता नहीं आपको सदस्यता के इवेंट की जानकारी मिल जाएगी. Google ग्रुप सदस्यताओं के काम करने का तरीका समझने के लिए, देखें किसी स्पेस में Google ग्रुप जोड़ना.
मिलते-जुलते विषय
- Google Workspace इवेंट का स्ट्रक्चर
- OAuth के दायरे चुनना
- इसके लिए, सदस्यता बनाएं Chat पर होने वाले इवेंट पाएँ