इस पेज पर, Google Chat के उन इवेंट के बारे में बताया गया है जिनकी सदस्यता Google Chat ऐप्लिकेशन का इस्तेमाल करके ली जा सकती है. आपको किस तरह के इवेंट की ज़रूरत है, यह तय करने के बाद सदस्यता लें, ताकि आपको Google Chat से इवेंट मिल सकें.
इवेंट की सदस्यता लेने के अलावा, Chat API को कॉल करके भी इवेंट के बारे में क्वेरी की जा सकती है. Chat API का इस्तेमाल करके, समय-समय पर इवेंट वापस पाए जा सकते हैं. इसके अलावा, ऐसे इवेंट देखे जा सकते हैं जो कुछ समय के लिए उपलब्ध न होने की वजह से, सदस्यता के दौरान आपसे छूट गए हों. Chat में इवेंट पाने और उनका जवाब देने के तरीक़ों के बारे में जानने के लिए, Chat के दस्तावेज़ में Google Chat के इवेंट के साथ काम करना देखें.
Chat में इस्तेमाल किए जा सकने वाले टारगेट संसाधन
Google Workspace Events API इन सदस्यताओं के साथ काम करता है:
- स्पेस,
space
संसाधनों के तौर पर दिखाए गए हैं - उपयोगकर्ताओं को Cloud Identity API
user
संसाधन के तौर पर दिखाया जाता है
Chat के साथ काम करने वाले इवेंट
Google Workspace की सदस्यताओं से आपको Chat में होने वाले इस तरह के बदलावों की जानकारी मिलती है:
- स्पेस में मौजूद नए, अपडेट किए गए या मिटाए गए मैसेज.
- किसी मैसेज पर मिली नई या हटाई गई प्रतिक्रियाएं.
- स्पेस में मौजूद नए, अपडेट किए गए या हटाए गए सदस्य.
- उस स्पेस में होने वाले बदलाव जिसकी आपने सदस्यता ली है. जैसे, स्पेस का अपडेट किया गया नाम या ब्यौरा.
सदस्यताएं बनाने के लिए इवेंट के टाइप
सदस्यता बनाते समय, eventTypes[]
फ़ील्ड का इस्तेमाल करके यह तय किया जाता है कि आपको किस तरह के इवेंट चाहिए. इवेंट के टाइप, CloudEvent के स्पेसिफ़िकेशन के मुताबिक फ़ॉर्मैट किए जाते हैं, जैसे कि google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
.
उदाहरण के लिए, किसी चैट स्पेस में शामिल होने वाले उपयोगकर्ताओं के इवेंट की जानकारी पाने के लिए, स्पेस को टारगेट संसाधन और इवेंट टाइप 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
) मिल सकें.
नीचे दी गई टेबल में, सदस्यता के लिए संभावित बैच इवेंट दिखाए गए हैं:
बैच इवेंट का टाइप | फ़ॉर्मैट |
---|---|
कई मैसेज पोस्ट किए गए हैं. |
|
एक से ज़्यादा मैसेज अपडेट किए गए हैं. |
|
एक से ज़्यादा मैसेज मिटा दिए जाते हैं. |
|
कई प्रतिक्रियाएं जनरेट हो जाती हैं. |
|
कई प्रतिक्रियाएं मिटा दी गई हैं. |
|
जिस स्पेस की सदस्यता ली गई है उसमें एक से ज़्यादा सदस्य जोड़ दिए गए हैं या सदस्यता लेने वाले उपयोगकर्ता को एक से ज़्यादा स्पेस में जोड़ दिया गया है. |
|
सदस्यता वाली जगह पर या उस उपयोगकर्ता के लिए, एक से ज़्यादा सदस्यताएं अपडेट हो जाती हैं जिसकी सदस्यता ली गई है. |
|
जिस स्पेस की सदस्यता ली गई है उससे एक से ज़्यादा सदस्यों को हटा दिया जाता है. इसके अलावा, उन स्पेस से भी हटा दिया जाता है जिनकी सदस्यता ली गई है. |
|
स्पेस में कई अपडेट हैं. |
|
इवेंट डेटा
इस सेक्शन में, Chat में होने वाले इवेंट के डेटा और पेलोड के उदाहरण दिए गए हैं.
जब आपकी Google Workspace सदस्यता को Chat से कोई इवेंट मिलता है, तो data
फ़ील्ड में इवेंट का पेलोड मौजूद होता है. इस पेलोड में, Google Workspace के संसाधन में हुए बदलावों की जानकारी मौजूद है. उदाहरण के लिए, अगर आपने किसी स्पेस में सदस्यता इवेंट की सदस्यता ली है, तो इन इवेंट के पेलोड में उस spaces.membership
संसाधन की जानकारी शामिल होती है जिसमें बदलाव हुआ है.
इवेंट पेलोड में संसाधन का डेटा
सदस्यता बनाते समय, यह तय किया जा सकता है कि आपको पेलोड में संसाधन के बारे में जानकारी शामिल करनी है या सिर्फ़ संसाधन का नाम. उदाहरण के लिए, अगर आपको चैट स्पेस में सदस्यों के बारे में इवेंट पाने हैं, तो आपके पास यह तय करने का विकल्प होता है कि इवेंट पेलोड में सदस्यता के संसाधन के कौनसे फ़ील्ड आपको शामिल करने हैं.
नीचे दी गई टेबल में, चैट स्पेस spaces/AAAABBBBBB
की सदस्यता के लिए JSON पेलोड के उदाहरण दिए गए हैं. सदस्यता को मिलने वाले हर इवेंट के लिए, पेलोड इवेंट के 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" } } |
मैसेज पर, उपयोगकर्ता, 😊 इमोजी और 💛 इमोजी का इस्तेमाल करके प्रतिक्रिया देते हैं. | 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.workspace.chat.spaces.v1.updated
). - पैसे चुकाकर ली जाने वाली सदस्यता के इवेंट पाने के लिए, यह ज़रूरी है कि उपयोगकर्ता, स्पेस का सदस्य हो. अगर किसी उपयोगकर्ता को Google ग्रुप के ज़रिए, स्पेस में जोड़ा गया, अपडेट किया गया या किसी अन्य तरीके से हटाया गया है, तो सदस्यता को वे सदस्यता इवेंट की जानकारी नहीं मिलेगी. Google ग्रुप की सदस्यताओं के काम करने का तरीका समझने के लिए, स्पेस में Google ग्रुप जोड़ना लेख पढ़ें.
मिलते-जुलते विषय
- Google Workspace इवेंट का स्ट्रक्चर
- OAuth के दायरे चुनना
- चैट इवेंट पाने के लिए सदस्यता बनाएं