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

इस पेज पर, Google Chat के उन इवेंट के बारे में बताया गया है जिनकी सदस्यता Google Chat ऐप्लिकेशन को Google Workspace इवेंट एपीआई का इस्तेमाल करके मिल सकती है.

Google Chat ऐप्लिकेशन बनाने के बारे में ज़्यादा जानने के लिए, Google Chat API की खास जानकारी देखें.

इस्तेमाल किए जा सकने वाले 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.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

सिर्फ़ आउटपुट के लिए इवेंट टाइप

google.workspace.APPLICATION.RESOURCE.VERSION.ACTION इवेंट टाइप की सदस्यता लेने पर, सदस्यता अपने-आप सेट अप हो जाती है. इससे, इवेंट टाइप के बैच किए गए वर्शन भी मिलते हैं. उदाहरण के लिए, google.workspace.chat.membership.v1.created की सदस्यता लेने पर आपको google.workspace.chat.membership.v1.batchCreated के इवेंट भी मिलते हैं.

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

इवेंट का टाइप जानकारी संसाधन का डेटा

google.workspace.chat.message.v1.batchCreated

एक ही समय पर कई मैसेज पोस्ट किए जाते हैं.

spaces.messages की सूची

google.workspace.chat.message.v1.batchUpdated

एक साथ कई मैसेज अपडेट किए जाते हैं.

spaces.messages की सूची

google.workspace.chat.reaction.v1.batchCreated

एक ही समय पर कई प्रतिक्रियाएं जनरेट की जाती हैं.

spaces.messages.reactions की सूची

google.workspace.chat.reaction.v1.batchDeleted

एक ही समय पर कई प्रतिक्रियाएं मिटा दी जाती हैं.

spaces.messages.reactions की सूची

google.workspace.chat.membership.v1.batchCreated

  • अगर target_resource एक स्पेस है, तो इसका मतलब है कि स्पेस में एक से ज़्यादा सदस्य बनाए गए हैं.
  • अगर target_resource, उपयोगकर्ता है: वह उपयोगकर्ता एक से ज़्यादा स्पेस का सदस्य बन जाता है.

spaces.memberships की सूची

google.workspace.chat.membership.v1.batchUpdated

  • अगर target_resource एक स्पेस है, तो: स्पेस में एक से ज़्यादा सदस्यों की जानकारी अपडेट की जाती है.
  • अगर target_resource उपयोगकर्ता है, तो: स्पेस के लिए, उपयोगकर्ता की सदस्यता में कई अपडेट हैं.

spaces.memberships की सूची

google.workspace.chat.membership.v1.batchDeleted

  • अगर target_resource एक स्पेस है, तो: स्पेस से एक से ज़्यादा सदस्य हटा दिए जाते हैं.
  • अगर target_resource उपयोगकर्ता है, तो: उपयोगकर्ता को कई स्पेस से सदस्य के तौर पर हटा दिया जाता है.

spaces.memberships की सूची

google.workspace.chat.space.v1.batchUpdated

स्पेस में कई अपडेट हैं.

spaces की सूची

इवेंट डेटा

इस सेक्शन में, इवेंट डेटा और 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"
    }
}
      
कोई उपयोगकर्ता, "सिम्बल लैब के लिए सेल्स टीम" में स्पेस की जानकारी अपडेट करता है. 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"
    }
}
      
स्पेस में एक ही समय पर, दो चैट उपयोगकर्ता जोड़े गए. 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"
    }
}
      
उपयोगकर्ता किसी मैसेज पर, 😊 इमोजी और HowTo इमोजी का इस्तेमाल करके, प्रतिक्रिया देते हैं. 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",
        }
      }
    ]
}