Google Chat के इवेंट की सदस्यता लेना

इस पेज पर, 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 इवेंट का स्ट्रक्चर सेक्शन देखें.

इस टेबल में बताया गया है कि स्पेस और उपयोगकर्ताओं की सदस्यताओं के लिए, किस तरह के इवेंट काम करते हैं. किसी इवेंट को ट्रिगर करने वाली चीज़ों के अपवादों के बारे में जानने के लिए, सीमाएं देखें.

इवेंट का टाइप फ़ॉर्मैट संसाधन का डेटा
स्पेस की सदस्यताएं  
एक मैसेज पोस्ट किया गया.

google.workspace.chat.message.v1.created

space.message
मैसेज अपडेट किया गया.

google.workspace.chat.message.v1.updated

space.message
एक मैसेज मिटाया गया.

google.workspace.chat.message.v1.deleted

space.message
इसके बाद, एक प्रतिक्रिया तैयार हो जाएगी.

google.workspace.chat.reaction.v1.created

space.message.reaction
प्रतिक्रिया मिटा दी गई है.

google.workspace.chat.reaction.v1.deleted

space.message.reaction
स्पेस में एक सदस्य को जोड़ दिया गया है.

google.workspace.chat.membership.v1.created

space.membership
स्पेस में किसी सदस्य को अपडेट किया गया है.

google.workspace.chat.membership.v1.updated

space.membership
एक सदस्य को स्पेस से हटा दिया गया है.

google.workspace.chat.membership.v1.deleted

space.membership
स्पेस को अपडेट किया गया है.

google.workspace.chat.space.v1.updated

space
स्पेस को मिटा दिया गया है.

google.workspace.chat.space.v1.deleted

space
उपयोगकर्ताओं की सदस्यताएं  
उपयोगकर्ता, स्पेस का सदस्य बन जाता है.

सभी नए सदस्य इवेंट ट्रिगर नहीं करते. ज़्यादा जानकारी के लिए, सीमाएं देखें

google.workspace.chat.membership.v1.created

space.membership
स्पेस में उपयोगकर्ता की सदस्यता अपडेट हो जाती है.

google.workspace.chat.membership.v1.updated

space.membership
स्पेस के सदस्य को सीधे तौर पर स्पेस से हटा दिया जाता है.

google.workspace.chat.membership.v1.deleted

space.membership

बैच इवेंट टाइप (सिर्फ़ आउटपुट)

आपने जिस तरह के इवेंट की सदस्यता ली है उनके साथ-साथ, 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.chat.message.v1.batchCreated
एक से ज़्यादा मैसेज अपडेट किए गए हैं.

google.workspace.chat.message.v1.batchUpdated
एक से ज़्यादा मैसेज मिटा दिए जाते हैं.

google.workspace.chat.message.v1.batchDeleted
कई प्रतिक्रियाएं जनरेट हो जाती हैं.

google.workspace.chat.reaction.v1.batchCreated
कई प्रतिक्रियाएं मिटा दी गई हैं.

google.workspace.chat.reaction.v1.batchDeleted
जिस स्पेस की सदस्यता ली गई है उसमें एक से ज़्यादा सदस्य जोड़ दिए गए हैं या सदस्यता लेने वाले उपयोगकर्ता को एक से ज़्यादा स्पेस में जोड़ दिया गया है.

google.workspace.chat.membership.v1.batchCreated
सदस्यता वाली जगह पर या उस उपयोगकर्ता के लिए, एक से ज़्यादा सदस्यताएं अपडेट हो जाती हैं जिसकी सदस्यता ली गई है.

google.workspace.chat.membership.v1.batchUpdated
जिस स्पेस की सदस्यता ली गई है उससे एक से ज़्यादा सदस्यों को हटा दिया जाता है. इसके अलावा, उन स्पेस से भी हटा दिया जाता है जिनकी सदस्यता ली गई है.

google.workspace.chat.membership.v1.batchDeleted
स्पेस में कई अपडेट हैं.

google.workspace.chat.space.v1.batchUpdated

इवेंट डेटा

इस सेक्शन में, Chat में होने वाले इवेंट के डेटा और पेलोड के उदाहरण दिए गए हैं.

जब आपकी Google Workspace सदस्यता को Chat से कोई इवेंट मिलता है, तो data फ़ील्ड में इवेंट का पेलोड मौजूद होता है. इस पेलोड में, Google Workspace के संसाधन में हुए बदलावों की जानकारी मौजूद है. उदाहरण के लिए, अगर आपने किसी स्पेस में सदस्यता इवेंट की सदस्यता ली है, तो इन इवेंट के पेलोड में उस spaces.membership संसाधन की जानकारी शामिल होती है जिसमें बदलाव हुआ है.

इवेंट पेलोड में संसाधन का डेटा

सदस्यता बनाते समय, यह तय किया जा सकता है कि आपको पेलोड में संसाधन के बारे में जानकारी शामिल करनी है या सिर्फ़ संसाधन का नाम. उदाहरण के लिए, अगर आपको चैट स्पेस में सदस्यों के बारे में इवेंट पाने हैं, तो आपके पास यह तय करने का विकल्प होता है कि इवेंट पेलोड में सदस्यता के संसाधन के कौनसे फ़ील्ड आपको शामिल करने हैं.

नीचे दी गई टेबल में, चैट स्पेस spaces/AAAABBBBBB की सदस्यता के लिए JSON पेलोड के उदाहरण दिए गए हैं. सदस्यता को मिलने वाले हर इवेंट के लिए, पेलोड इवेंट के data फ़ील्ड में दिखता है:

उदाहरण इवेंट का टाइप JSON पेलोड

किसी व्यक्ति ने स्पेस में "नमस्ते वर्ल्ड" मैसेज पोस्ट किया है.

google.workspace.chat.message.v1.created

संसाधन का डेटा शामिल है
{
    "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"
    }
}
कोई उपयोगकर्ता, स्पेस मैनेजर बन जाता है.

google.workspace.chat.membership.v1.updated

संसाधन का डेटा शामिल है
{
    "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 ग्रुप जोड़ना लेख पढ़ें.