इस पेज पर, Chat के उन इवेंट के बारे में बताया गया है जिनकी सदस्यता, Chat ऐप्लिकेशन Google Workspace Events API का इस्तेमाल करके ले सकता है. आपको किस तरह के इवेंट चाहिए, यह तय करने के बाद, Chat से इवेंट पाने के लिए सदस्यता लें.
इवेंट की सूचना पाने के लिए सदस्यता लेने के अलावा, Google Chat API को कॉल करके भी इवेंट के बारे में क्वेरी की जा सकती है. Chat API को कॉल करने से, आपको समय-समय पर इवेंट वापस पाने में मदद मिलती है. इसके अलावा, अगर किसी गड़बड़ी की वजह से आपको सदस्यता से जुड़े इवेंट नहीं मिल पाए हैं, तो उन्हें वापस पाने में भी मदद मिलती है. Chat इवेंट पाने और उनका जवाब देने के तरीकों के बारे में जानने के लिए, Chat के दस्तावेज़ में Chat के इवेंट इस्तेमाल करना लेख पढ़ें.
चैट के साथ काम करने वाले इवेंट
Google Workspace की सदस्यताओं की मदद से, Chat में होने वाले इन बदलावों के बारे में इवेंट पाए जा सकते हैं:
- स्पेस में मौजूद नए, अपडेट किए गए या मिटाए गए मैसेज.
- किसी मैसेज पर नई प्रतिक्रियाएं मिलना या प्रतिक्रियाएं हटाना.
- स्पेस में सदस्यों को जोड़ा गया, हटाया गया या उनकी भूमिका अपडेट की गई.
- आपने जिस स्पेस की सदस्यता ली है उसमें किए गए बदलावों के बारे में सूचनाएं. जैसे, स्पेस का अपडेट किया गया नाम या ब्यौरा.
- उपयोगकर्ता की उपलब्धता में बदलाव.
- उपयोगकर्ता के spaceReadState या threadReadState में हुए बदलाव.
ऐसे संसाधन जिनके इवेंट को मॉनिटर किया जा सकता है
इवेंट पाने के लिए, आपको मॉनिटर करने के लिए Chat रिसॉर्स तय करना होता है. इसे सदस्यता का टारगेट रिसॉर्स कहा जाता है.
Google Workspace Events API, Chat के लिए इन टारगेट रिसोर्स के साथ काम करता है:
| टारगेट रिसॉर्स | फ़ॉर्मैट | सीमाएं |
|---|---|---|
| स्पेस |
यहां SPACE, Chat API |
सदस्यता की पुष्टि करने वाला Chat उपयोगकर्ता या Chat ऐप्लिकेशन, Google Workspace या Google खाते से स्पेस का सदस्य होना चाहिए. इनके साथ काम करता है: |
| किसी उपयोगकर्ता के सभी स्पेस |
|
सदस्यता को सिर्फ़ उन स्पेस के इवेंट मिलते हैं जिनमें उपयोगकर्ता, Google Workspace या Google खाते से सदस्य है. यह सिर्फ़ उपयोगकर्ता की पुष्टि करने की सुविधा के साथ काम करता है. |
| उपयोगकर्ता |
यहां USER, Chat API |
सदस्यता को सिर्फ़ उस उपयोगकर्ता के बारे में इवेंट मिलते हैं जिसने सदस्यता के लिए अनुमति दी है. कोई उपयोगकर्ता, अन्य उपयोगकर्ताओं की ओर से सदस्यता को अनुमति नहीं दे सकता. यह सिर्फ़ उपयोगकर्ता की पुष्टि करने की सुविधा के साथ काम करता है. |
| ग्राहक ( डेवलपर के लिए झलक) |
यहां CUSTOMER ग्राहक आईडी है. Chat ऐप्लिकेशन के ग्राहक डोमेन के लिए, |
इस सदस्यता को, ग्राहक के डोमेन से मैनेज किए जाने वाले सभी स्पेस और उपयोगकर्ताओं के इवेंट मिलते हैं. सिर्फ़ एडमिन की मंज़ूरी के साथ ऐप्लिकेशन की पुष्टि करने की सुविधा काम करती है. |
सदस्यताएं बनाने के लिए इवेंट टाइप
सदस्यता बनाते समय, eventTypes[] फ़ील्ड का इस्तेमाल करके यह बताएं कि आपको किस तरह के इवेंट की सूचनाएं चाहिए. इवेंट टाइप को CloudEvents स्पेसिफ़िकेशन के मुताबिक फ़ॉर्मैट किया जाता है. जैसे, google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.
उदाहरण के लिए, Chat स्पेस में शामिल होने वाले उपयोगकर्ताओं के बारे में इवेंट पाने के लिए, स्पेस को टारगेट रिसॉर्स के तौर पर और इवेंट टाइप को google.workspace.chat.membership.v1.created के तौर पर सेट करें. किसी स्पेस में शामिल होने वाले उपयोगकर्ता के बारे में इवेंट पाने के लिए, उपयोगकर्ता को टारगेट रिसॉर्स के तौर पर और इवेंट टाइप को google.workspace.chat.membership.v1.created के तौर पर सेट करें. इवेंट के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Google Workspace इवेंट का स्ट्रक्चर लेख पढ़ें.
यहां दी गई टेबल में बताया गया है कि स्पेस की सदस्यताएं और उपयोगकर्ताओं की सदस्यताओं के लिए, किस तरह के इवेंट इस्तेमाल किए जा सकते हैं. इवेंट को ट्रिगर करने वाली स्थितियों के बारे में अपवादों के बारे में जानने के लिए, सीमाएं लेख पढ़ें.
| इवेंट का टाइप | फ़ॉर्मैट | संसाधन का डेटा | ||
|---|---|---|---|---|
| स्पेस की सदस्यताएं | ||||
| मैसेज पोस्ट किया गया है. |
|
|
||
| मैसेज अपडेट किया गया है. |
|
|
||
| मैसेज मिटा दिया जाता है. |
|
|
||
| प्रतिक्रिया दी जाती है. |
|
|
||
| प्रतिक्रिया मिटाई गई. |
|
|
||
| स्पेस में कोई सदस्य जोड़ा गया हो. |
|
|
||
| स्पेस में किसी सदस्य की जानकारी अपडेट की गई है. |
|
|
||
| किसी सदस्य को स्पेस से हटा दिया जाता है. |
|
|
||
| स्पेस अपडेट हो गया है. |
|
|
||
| स्पेस मिटा दिया जाता है. |
|
|
||
| उपयोगकर्ताओं को सदस्यताएं असाइन करना | ||||
| उपयोगकर्ता, स्पेस का सदस्य बन जाता है.
सभी नए सदस्यों से इवेंट ट्रिगर नहीं होते. ज़्यादा जानकारी के लिए, सीमाएं लेख पढ़ें |
|
|
||
| किसी स्पेस में उपयोगकर्ता की सदस्यता अपडेट की जाती है. |
|
|
||
| उपयोगकर्ता को स्पेस के डायरेक्ट सदस्य के तौर पर हटा दिया जाता है. |
|
|
||
| उपयोगकर्ता के स्पेस को पढ़ने की स्थिति अपडेट की जाती है. |
|
|
||
| उपयोगकर्ता के थ्रेड को पढ़े जाने की स्थिति अपडेट की जाती है. |
|
|
||
| उपयोगकर्ताओं के लिए सदस्यताएं ( डेवलपर के लिए झलक) | ||||
| आपके Google Workspace संगठन में मौजूद किसी स्पेस, मैसेज, प्रतिक्रिया, सदस्यता या उपयोगकर्ता के मैसेज पढ़े जाने की स्थिति में कोई बदलाव होता है. |
यह स्पेस और उपयोगकर्ता की सदस्यताओं के लिए, सूची में दिए गए सभी इवेंट टाइप के साथ काम करता है. |
यह इवेंट के टाइप पर निर्भर करता है. उदाहरण के लिए, |
||
बैच इवेंट के टाइप (सिर्फ़ आउटपुट)
आपने जिन इवेंट टाइप की सदस्यता ली है उनके अलावा, आपको बैच इवेंट भी मिल सकते हैं. बैच इवेंट, एक ही तरह के कई इवेंट को दिखाता है. ये इवेंट, कम समय में होते हैं. बैच इवेंट के पेलोड में, बदले गए सभी संसाधनों की सूची होती है.
उदाहरण के लिए, अगर कोई उपयोगकर्ता एक साथ किसी स्पेस में 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 संसाधन के बारे में जानकारी होती है.
इवेंट पेलोड में मौजूद संसाधन का डेटा
सदस्यता बनाते समय, यह तय किया जा सकता है कि आपको पेलोड में संसाधन के बारे में जानकारी शामिल करनी है या सिर्फ़ संसाधन का नाम. उदाहरण के लिए, अगर आपको किसी Chat स्पेस में शामिल सदस्यों के बारे में इवेंट पाने हैं, तो यह तय करें कि आपको इवेंट पेलोड में सदस्यता संसाधन के कौनसे फ़ील्ड चाहिए.
इस टेबल में, चैट स्पेस spaces/AAAABBBBBB की सदस्यता के लिए JSON पेलोड के उदाहरण दिए गए हैं. सदस्यता को मिलने वाले हर इवेंट के लिए, पेलोड इवेंट के data फ़ील्ड में दिखता है:
| उदाहरण | इवेंट का टाइप | JSON पेलोड |
|---|---|---|
किसी उपयोगकर्ता ने स्पेस में "सभी को नमस्ते" मैसेज पोस्ट किया. |
|
इसमें संसाधन का डेटा शामिल होता है:
{
"message":
{
"name": "spaces/इसमें संसाधन का डेटा शामिल नहीं है:
{
"message":
{
"name": "spaces/ |
| कोई उपयोगकर्ता स्पेस मैनेजर बन जाता है. |
|
इसमें संसाधन का डेटा शामिल होता है:
{
"membership":
{
"name": "spaces/इसमें संसाधन का डेटा शामिल नहीं है:
{
"membership":
{
"name": "spaces/ |
| कोई उपयोगकर्ता स्पेस के ब्यौरे को "Cymbal Labs की सेल्स टीम" के तौर पर अपडेट करता है. | google.workspace.chat.space.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"space":
{
"name": "spaces/इसमें संसाधन का डेटा शामिल नहीं है:
{
"space":
{
"name": "spaces/ |
| Chat के दो उपयोगकर्ताओं को एक ही समय पर स्पेस में जोड़ा गया था. | google.workspace.chat.membership.v1.batchCreated |
इसमें संसाधन का डेटा शामिल होता है:
{
"memberships": [
{
"membership": {
"name": "spaces/इसमें संसाधन का डेटा शामिल नहीं है:
{
"memberships": [
{
"membership": {
"name": "spaces/ |
| किसी उपयोगकर्ता ने 😊 इमोजी का इस्तेमाल करके, मैसेज पर प्रतिक्रिया दी है. | google.workspace.chat.reaction.v1.created |
इसमें संसाधन का डेटा शामिल होता है:
{
"reaction":
{
"name": "spaces/इसमें संसाधन का डेटा शामिल नहीं है:
{
"reaction":
{
"name": "spaces/ |
| उपयोगकर्ता, मैसेज पर 😊 और 😸 इमोजी से प्रतिक्रिया देते हैं. | google.workspace.chat.reaction.v1.batchCreated |
इसमें संसाधन का डेटा शामिल होता है:
{
"reactions": [
{
"reaction": {
"name": "spaces/इसमें संसाधन का डेटा शामिल नहीं है:
{
"reactions": [
{
"reaction": {
"name": "spaces/ |
| कोई उपयोगकर्ता ऐसे स्पेस पर जाता है जिसे उसने पढ़ा नहीं है. इससे स्पेस के पढ़े जाने की स्थिति अपडेट हो जाती है. | google.workspace.chat.spaceReadState.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"spaceReadState": {
"name": "users/इसमें संसाधन का डेटा शामिल नहीं है:
{
"spaceReadState": {
"name": "users/ |
| कोई उपयोगकर्ता किसी थ्रेड में मौजूद मैसेज पढ़ता है. इससे, थ्रेड के पढ़े जाने की स्थिति अपडेट हो जाती है. | google.workspace.chat.threadReadState.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"threadReadState": {
"name": "users/इसमें संसाधन का डेटा शामिल नहीं है:
{
"threadReadState": {
"name": "users/ |
| कोई उपयोगकर्ता Chat में उपलब्ध हो जाता है. | google.workspace.chat.availability.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"availability":
{
"name": "users/USER_ID/availability",
"state": "ACTIVE"
}
}
इसमें संसाधन का डेटा शामिल नहीं है:
{
"availability":
{
"name": "users/USER_ID/availability",
}
}
|
| जब कोई उपयोगकर्ता Chat में कुछ समय तक कोई गतिविधि नहीं करता है. | google.workspace.chat.availability.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"availability":
{
"name": "users/USER_ID/availability",
"state": "IDLE",
}
}
इसमें संसाधन का डेटा शामिल नहीं है:
{
"availability":
{
"name": "users/USER_ID/availability",
}
}
|
कोई उपयोगकर्ता, Chat में अपनी उपलब्धता की स्थिति को Away पर सेट करता है. |
google.workspace.chat.availability.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"availability":
{
"name": "users/USER_ID/availability",
"state": "AWAY",
}
}
इसमें संसाधन का डेटा शामिल नहीं है:
{
"availability":
{
"name": "users/USER_ID/availability",
}
}
|
कोई उपयोगकर्ता, Chat में अपनी उपलब्धता की स्थिति को Do not disturb पर सेट करता है. |
google.workspace.chat.availability.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"availability":
{
"name": "users/USER_ID/availability",
"state": "DO_NOT_DISTURB",
"doNotDisturbMetadata": {
"expirationTime": "2026-03-24T18:36:31.337Z"
}
}
}
इसमें संसाधन का डेटा शामिल नहीं है:
{
"availability":
{
"name": "users/USER_ID/availability",
}
}
|
| कोई उपयोगकर्ता, Chat पर पसंद के मुताबिक स्टेटस सेट करता है. | google.workspace.chat.availability.v1.updated |
इसमें संसाधन का डेटा शामिल होता है:
{
"availability":
{
"name": "users/USER_ID/availability",
"state": "ACTIVE",
"customStatus": {
"text": "Be right back",
"emoji": {
"unicode": "👟"
},
"expireTime": "2026-03-24T18:38:05.583655Z"
}
}
}
इसमें संसाधन का डेटा शामिल नहीं है:
{
"availability":
{
"name": "users/USER_ID/availability",
}
}
|
सीमाएं और डिलीवरी के तरीके
सामान्य सीमाएं
- सदस्यता से जुड़े इवेंट पाने के लिए, उपयोगकर्ता या Chat ऐप्लिकेशन को स्पेस का सदस्य होना चाहिए. अगर उन्हें Google ग्रुप के ज़रिए स्पेस में जोड़ा गया है, अपडेट किया गया है या हटाया गया है, तो सदस्यता को इन इवेंट की सूचना नहीं मिलती. Google ग्रुप की सदस्यताएं कैसे काम करती हैं, यह जानने के लिए किसी स्पेस में Google ग्रुप जोड़ना लेख पढ़ें.
उपयोगकर्ता की सदस्यताएं
-
उपयोगकर्ताओं की सदस्यताओं के लिए, डायरेक्ट मैसेज या बिना नाम वाली ग्रुप चैट (
google.workspace.chat.membership.v1.created) में नए सदस्यों के बारे में इवेंट, सिर्फ़ पहला मैसेज पोस्ट होने के बाद ट्रिगर होते हैं.
ग्राहक की सदस्यताएं ( डेवलपर के लिए झलक)
ग्राहक की सदस्यताओं के लिए, ये सीमाएं लागू होती हैं:
- Google Workspace संगठन के पास कम से कम एक Enterprise एसकेयू का लाइसेंस होना चाहिए. ध्यान दें कि डेवलपर प्रीव्यू प्रोग्राम के दौरान, इस ज़रूरी शर्त का पालन करना ज़रूरी नहीं है. हालांकि, आने वाले समय में इसका पालन करना ज़रूरी होगा. इसके बारे में अलग से सूचना दी जाएगी.
- 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 इवेंट का स्ट्रक्चर
- OAuth के दायरे चुनें
- Chat इवेंट पाने के लिए, सदस्यता लें