Google Workspace Events API का इस्तेमाल करके इवेंट की सदस्यता लेना

इस पेज पर, Google Workspace Events API की खास जानकारी दी गई है. साथ ही, इसमें बताया गया है कि Google Workspace में मौजूद अलग-अलग ऐप्लिकेशन के इवेंट की सदस्यता लेने के लिए, इस एपीआई का इस्तेमाल कैसे किया जाता है.

Google Workspace इवेंट, Google Workspace के संसाधनों में होने वाले बदलावों को दिखाते हैं. जैसे, संसाधन कब बनाए गए, अपडेट किए गए या मिटाए गए. Google Workspace के किसी संसाधन की सदस्यता लेने और उससे जुड़े इवेंट पाने के लिए, Google Workspace Events API का इस्तेमाल करें.

आपका ऐप्लिकेशन, इवेंट कैसे पाता है

अपने ऐप्लिकेशन को Google Workspace के इवेंट पाने की अनुमति देने के लिए, Google Workspace Events API का इस्तेमाल करके, Google Workspace के संसाधनों की सदस्यताएं बनाएं.

यहां दिए गए उदाहरण में बताया गया है कि Google Workspace Events API, सदस्यता के ज़रिए Chat ऐप्लिकेशन को इवेंट कैसे डिलीवर करता है:

1. कोई Chat ऐप्लिकेशन, Google Chat के किसी स्पेस की सदस्यता लेता है.
2. Chat स्पेस में बदलाव होता है. उदाहरण के लिए, स्पेस में कोई नया मैसेज पोस्ट किया जाता है.
3. Chat, Google Cloud Pub/Sub में मौजूद किसी विषय पर एक इवेंट डिलीवर करता है. यह विषय, सदस्यता के लिए सूचना एंडपॉइंट के तौर पर काम करता है. इवेंट में, बदलाव के बारे में डेटा होता है. उदाहरण के लिए, नए मैसेज के बारे में किसी इवेंट के लिए, इवेंट में बनाए गए Message संसाधन के बारे में जानकारी होती है.
4. Chat ऐप्लिकेशन, Google Cloud Pub/Sub के उस मैसेज को प्रोसेस करता है जिसमें इवेंट शामिल होता है. साथ ही, ज़रूरत पड़ने पर कार्रवाई करता है.

अहम शब्दावली

Google Workspace Events API में इस्तेमाल किए जाने वाले सामान्य शब्द यहां दिए गए हैं:

Google Workspace इवेंट

Google Workspace के किसी संसाधन में होने वाला बदलाव. इवेंट, CloudEvents की खास जानकारी का इस्तेमाल करके फ़ॉर्मैट किए जाते हैं. ये सदस्यता इवेंट या लाइफ़साइकल इवेंट हो सकते हैं:

सदस्यता इवेंट

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

लाइफ़साइकल इवेंट

Google Workspace की सदस्यता के बारे में कोई इवेंट. लाइफ़साइकल इवेंट से आपको समस्याओं और अपनी सदस्यता की स्थिति के बारे में सूचना मिलती है, ताकि आपसे सदस्यता इवेंट न छूटें. डिफ़ॉल्ट रूप से, आपकी सदस्यता को हमेशा लाइफ़साइकल इवेंट मिलते हैं. ज़्यादा जानकारी के लिए, Google Workspace की सदस्यताओं के लिए लाइफ़साइकल इवेंट देखें.

Google Workspace की सदस्यता

यह एक नाम वाली इकाई है, जो Google Workspace के किसी ऐप्लिकेशन के संसाधन को मॉनिटर करती है. सदस्यता को Subscription संसाधन के तौर पर दिखाया जाता है. सदस्यता को इन जानकारी के आधार पर तय किया जाता है:

टारगेट रिसॉर्स

Google Workspace का वह संसाधन जिसे मॉनिटर करना है. इस संसाधन को, Google Workspace की सदस्यता के targetResource फ़ील्ड में दिखाया जाता है. हर सदस्यता, सिर्फ़ एक संसाधन को मॉनिटर कर सकती है. यह देखने के लिए कि Google Workspace Events API, Google Workspace के किन संसाधनों के साथ काम करता है, देखें Google Workspace के साथ काम करने वाले इवेंट.

इवेंट के टाइप

बदलाव के वे टाइप जिनके बारे में आपको टारगेट रिसॉर्स के लिए सूचना चाहिए. उदाहरण के लिए, अगर आपने किसी Chat स्पेस की सदस्यता ली है, तो आपके पास यह चुनने का विकल्प होता है कि आपको स्पेस और उसके चाइल्ड रिसॉर्स, जैसे कि सदस्यताओं और मैसेज के बारे में इवेंट चाहिए या नहीं.

सूचना एंडपॉइंट

वह एंडपॉइंट जहां Google Workspace की सदस्यता को इवेंट मिलते हैं. Google Workspace Events API, Google Cloud Pub/Sub के विषयों को सूचना एंडपॉइंट के तौर पर इस्तेमाल करने की अनुमति देता है. Google Cloud Pub/Sub के इस्तेमाल के बारे में ज़्यादा जानने के लिए, Google Cloud Pub/Sub का दस्तावेज़ देखें.

पेलोड के विकल्प

बदले गए संसाधनों के बारे में वह इवेंट डेटा जो आपको चाहिए.

Google Workspace के साथ काम करने वाले इवेंट

आपका ऐप्लिकेशन, किन इवेंट को पा सकता है, यह आपकी सदस्यता के टारगेट रिसॉर्स पर निर्भर करता है. यहां दी गई टेबल में, हर संभावित टारगेट रिसॉर्स के लिए काम करने वाले इवेंट दिखाए गए हैं.

ज़्यादा जानने के लिए, ये गाइड देखें:

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

Google Workspace के इवेंट का स्ट्रक्चर

Google Workspace के इवेंट, CloudEvents खास जानकारी के मुताबिक होते हैं. यह इवेंट डेटा के बारे में बताने का इंडस्ट्री-स्टैंडर्ड तरीका है. Google Workspace के इवेंट में ये चीज़ें शामिल होती हैं:

• CloudEvent के एट्रिब्यूट.
• डेटा Google Workspace के उस संसाधन के बारे में जिसमें इवेंट के नतीजे के तौर पर बदलाव हुआ है

इस सेक्शन में, Google Workspace के इवेंट के एट्रिब्यूट और डेटा के स्ट्रक्चर के बारे में बताया गया है.

CloudEvent के एट्रिब्यूट

Google Workspace के इवेंट में, CloudEvents के ये ज़रूरी एट्रिब्यूट शामिल होते हैं:

इवेंट का डेटा

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

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

सदस्यता बनाते समय, यह तय किया जा सकता है कि आपके ऐप्लिकेशन को मिलने वाले इवेंट में, संसाधन का कितना डेटा शामिल करना है.

इवेंट डेटा के लिए ये विकल्प, आपकी सदस्यता के payloadOptions फ़ील्ड में दिखाए जाते हैं.

Google Cloud Pub/Sub के मैसेज के तौर पर इवेंट

Google Workspace Events API की सदस्यताओं में, Google Cloud Pub/Sub के विषयों को सूचना एंडपॉइंट के तौर पर इस्तेमाल किया जाता है. इस एंडपॉइंट पर, Google Workspace के इवेंट मिलते हैं. इवेंट को Google Cloud Pub/Sub के मैसेज के तौर पर एनकोड किया जाता है. आपका ऐप्लिकेशन, Google Cloud Pub/Sub के मैसेज को प्रोसेस करके, इवेंट के जवाब में कार्रवाई कर सकता है.

यहां दिए गए उदाहरण में, Google Cloud Pub/Sub का एक ऐसा मैसेज दिखाया गया है जिसमें Chat स्पेस में अपडेट किए गए मैसेज के बारे में इवेंट शामिल है:

 {
    "message":
    {
        "attributes":
        {
            "ce-datacontenttype": "application/json",
            "ce-id": "spaces/SPACE_ID/spaceEvents/SPACE_EVENT_ID",
            "ce-source": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
            "ce-specversion": "1.0",
            "ce-subject": "//chat.googleapis.com/spaces/SPACE_ID",
            "ce-time": "2023-09-07T21:37:53.274191Z",
            "ce-type": "google.workspace.chat.message.v1.updated"
        },
        "data": "EVENT_DATA",
        "messageId": "PUBSUB_MESSAGE_ID",
        "orderingKey": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
        "publishTime": "2023-09-07T21:37:53.713Z"
    }
}

इस उदाहरण में ये फ़ील्ड शामिल हैं:

• attributes: CloudEvent के एट्रिब्यूट. इनमें इवेंट का टाइप शामिल होता है. इस मामले में, इवेंट स्पेस में अपडेट किए गए मैसेज के बारे में है.
• data: अपडेट किए गए spaces.message संसाधन के बारे में जानकारी वाला इवेंट डेटा. इसे Base64-encoded स्ट्रिंग के तौर पर फ़ॉर्मैट किया गया है.
• messageId: Google Cloud Pub/Sub के मैसेज के लिए आइडेंटिफ़ायर.

Google Cloud Pub/Sub मैसेज में CloudEvents के बारे में ज़्यादा जानने के लिए, CloudEvents के लिए Google Cloud Pub/Sub प्रोटोकॉल बाइंडिंग देखें.

मिलते-जुलते विषय

• Google Workspace Events API के स्कोप चुनना
• Google Workspace की सदस्यता बनाना