इस गाइड में, Google Chat API के SpaceEvent
रिसॉर्स पर get()
तरीके का इस्तेमाल करने का तरीका बताया गया है. इससे Google Chat स्पेस में मौजूद किसी इवेंट के बारे में जानकारी मिलती है.
SpaceEvent
संसाधन, किसी स्पेस या उसके चाइल्ड रिसॉर्स में हुए बदलाव को दिखाता है. जैसे, मैसेज, प्रतिक्रियाएं, और सदस्यताएं. इवेंट के उन टाइप के बारे में जानने के लिए, SpaceEvent
संसाधन के eventType
फ़ील्ड
का रेफ़रंस दस्तावेज़ देखें.
अनुरोध करने की तारीख से 28 दिन पहले तक के इवेंट के लिए अनुरोध किया जा सकता है. इवेंट में, बदली गई संसाधन फ़ाइल का सबसे नया वर्शन शामिल होता है. उदाहरण के लिए, अगर आपने किसी नए मैसेज के बारे में इवेंट का अनुरोध किया है, लेकिन बाद में मैसेज को अपडेट कर दिया गया है, तो सर्वर, इवेंट पेलोड में अपडेट किया गया Message
संसाधन दिखाता है.
इस तरीके को कॉल करने के लिए, आपको उपयोगकर्ता की पुष्टि करनी होगी. किसी इवेंट की जानकारी पाने के लिए, पुष्टि किए गए उपयोगकर्ता का उस स्पेस का सदस्य होना ज़रूरी है जहां इवेंट हुआ था.
ज़रूरी शर्तें
Node.js
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, नाम, आइकॉन, और जानकारी के साथ Google Chat API चालू करें और उसे कॉन्फ़िगर करें.
- Node.js Cloud Client Library इंस्टॉल करें.
-
डेस्कटॉप ऐप्लिकेशन के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इस गाइड में दिए गए सैंपल को चलाने के लिए, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- अनुमति का ऐसा दायरा चुनें जो उपयोगकर्ता की पुष्टि करने की सुविधा के साथ काम करता हो.
किसी स्पेस इवेंट के बारे में जानकारी पाना
Google Chat में किसी स्पेस इवेंट के बारे में जानकारी पाने के लिए, अपने अनुरोध में यह जानकारी शामिल करें:
- अपने अनुरोध में, अनुमति का ऐसा स्कोप तय करें जो इवेंट टाइप के साथ काम करता हो. सबसे सही तरीका यह है कि आप सबसे सीमित स्कोप चुनें, ताकि आपका ऐप्लिकेशन काम कर सके.
GetSpaceEvent()
तरीके को कॉल करें. साथ ही, स्पेस इवेंट काname
पास करें, ताकि उसे हासिल किया जा सके.
यहां दिए गए उदाहरण में, स्पेस इवेंट पाने का तरीका बताया गया है:
Node.js
इस सैंपल को चलाने के लिए, इन्हें बदलें:
SCOPE_NAME
: इवेंट टाइप के आधार पर अनुमति का दायरा. उदाहरण के लिए, अगर आपको नई सदस्यता के बारे में कोई स्पेस इवेंट मिल रहा है, तोchat.memberships.readonly
स्कोप का इस्तेमाल करें. इसेhttps://www.googleapis.com/auth/chat.memberships.readonly
के तौर पर फ़ॉर्मैट किया गया है.ListSpaceEvents()
तरीके से, इवेंट टाइप की जानकारी पाई जा सकती है. इस तरीके का इस्तेमाल करने का तरीका जानने के लिए, किसी स्पेस के इवेंट की सूची बनाना लेख पढ़ें.SPACE_NAME
: स्पेस केname
का आईडी. आईडी पाने के लिए,ListSpaces()
तरीके का इस्तेमाल करें या स्पेस के यूआरएल से आईडी पाएं.SPACE_EVENT_NAME
: स्पेस इवेंट केname
का आईडी. आपको आईडी,ListSpaceEvents()
तरीके से मिल सकता है. इस तरीके का इस्तेमाल करने का तरीका जानने के लिए, किसी स्पेस के इवेंट की सूची बनाना लेख पढ़ें.
Chat API, इवेंट की जानकारी के साथ SpaceEvent
का एक इंस्टेंस दिखाता है.