इस दस्तावेज़ में, Google Cloud Pub/Sub से Google Meet इवेंट पाने और उनके जवाब देने का तरीका बताया गया है.
Meet इवेंट, Meet संसाधन में हुई किसी गतिविधि या बदलाव को दिखाता है. जैसे, नई मीटिंग बनाना. इवेंट का इस्तेमाल करके, यह समझा जा सकता है कि क्या हुआ. इसके बाद, कार्रवाई की जा सकती है या अपने उपयोगकर्ताओं के लिए सही तरीके से जवाब दिया जा सकता है.
यहां इवेंट इस्तेमाल करने के कुछ उदाहरण दिए गए हैं:
मीटिंग में होने वाले बदलावों को देखना और उनके हिसाब से काम करना. जैसे, मीटिंग शुरू या खत्म होने पर.
यह ट्रैक करना कि मीटिंग में कौन-कौन शामिल हुआ, ताकि कानूनी या ट्रेनिंग से जुड़ी ज़रूरतों को पूरा किया जा सके.
मीटिंग की ट्रांसक्रिप्ट को सुनें, ताकि फ़ाइल के कॉन्टेंट को पार्स किया जा सके और उसे सीआरएम या डेटाबेस में लॉग किया जा सके.
इवेंट कैसे काम करते हैं
Google Meet में जब भी कोई गतिविधि होती है, तब Google Meet REST API संसाधन बनाया जाता है या उसे अपडेट किया जाता है. Meet, इवेंट का इस्तेमाल करके आपके ऐप्लिकेशन को यह जानकारी देता है कि किस तरह की गतिविधि हुई और Meet REST API के किस संसाधन पर इसका असर पड़ा.
Space संसाधन बनता है. इसके बाद, Meet एक इवेंट बनाता है.Meet, इवेंट को टाइप के हिसाब से कैटगरी में बांटता है. इवेंट टाइप की मदद से, सिर्फ़ अपनी ज़रूरत के हिसाब से जानकारी को फ़िल्टर किया जा सकता है और उसे पाया जा सकता है. साथ ही, एक जैसी गतिविधियों को एक ही तरीके से मैनेज किया जा सकता है.
यहां दिए गए उदाहरण से पता चलता है कि Meet में की गई किसी गतिविधि का असर, Meet REST API से जुड़े संसाधन पर कैसे पड़ता है. साथ ही, यह भी पता चलता है कि आपका Meet ऐप्लिकेशन किस तरह का इवेंट पाता है:
| गतिविधि | Meet REST API संसाधन | इवेंट किस तरह का है |
|---|---|---|
| जब कोई उपयोगकर्ता किसी मीटिंग स्पेस में शामिल होता है. | ConferenceRecord संसाधन बनाया जाता है. |
कॉन्फ़्रेंस का नया रिकॉर्ड |
Google Meet से इवेंट का डेटा पाना
इवेंट का डेटा पाने के लिए, आपका ऐप्लिकेशन इनमें से कोई एक काम कर सकता है:
इवेंट होने पर उनकी सूचना पाने के लिए, Google Workspace Events API का इस्तेमाल करके इवेंट की सदस्यता लें. ज़्यादा जानकारी के लिए, Google Meet इवेंट की सूचनाएं पाने के लिए सदस्यता लेना लेख पढ़ें.
Meet REST API को कॉल करके, हाल ही के डेटा के लिए क्वेरी करें.
यहां दी गई टेबल में, इवेंट की सदस्यता लेने और उनके लिए क्वेरी करने के बीच का अंतर और इसकी वजहें बताई गई हैं:
| इवेंट के लिए सदस्यता लेना | डेटा से जुड़ी क्वेरी करना | |
|---|---|---|
| उपयोग के उदाहरण |
|
|
| एपीआई | Google Workspace Events API | Meet REST API |
| इवेंट का सोर्स | कॉन्फ़्रेंस रिकॉर्ड और उपयोगकर्ता | स्पेस और कॉन्फ़्रेंस रिकॉर्ड |
| इस्तेमाल किए जा सकने वाले इवेंट |
कॉन्फ़्रेंस रिकॉर्ड
साथ काम करने वाले इवेंट टाइप की सूची देखने के लिए, Google Workspace Events API के दस्तावेज़ में सदस्यताएं बनाने के लिए इवेंट टाइप देखें. |
स्पेस और कॉन्फ़्रेंस रिकॉर्ड
Meet REST API के दस्तावेज़ में, इस्तेमाल किए जा सकने वाले एंडपॉइंट की सूची देखने के लिए, Space रिसॉर्स और ConferenceRecord रिसॉर्स देखें.
|
| इवेंट का फ़ॉर्मैट | CloudEvent स्पेसिफ़िकेशन के मुताबिक फ़ॉर्मैट किया गया Google Cloud Pub/Sub मैसेज. ज़्यादा जानकारी के लिए, Google Workspace इवेंट का स्ट्रक्चर देखें. |
Meet REST API का संसाधन (Space और ConferenceRecord)
|
| इवेंट का डेटा | Base64 में कोड में बदली गई स्ट्रिंग, जिसमें संसाधन का डेटा शामिल हो भी सकता है और नहीं भी. उदाहरण के लिए पेलोड देखने के लिए, इवेंट डेटा देखें. |
JSON पेलोड, जिसमें संसाधन का डेटा शामिल होता है. उदाहरण के लिए पेलोड देखने के लिए, रेफ़रंस दस्तावेज़ में ConferenceRecord
संसाधन देखें.
|
उदाहरण: मीटिंग स्पेस में शामिल लोगों के बारे में इवेंट वापस पाना
इस उदाहरण में, Meet ऐप्लिकेशन को मीटिंग स्पेस में हिस्सा लेने वाले लोगों की जानकारी चाहिए. मीटिंग स्पेस में, कोई व्यक्ति चालू कॉन्फ़्रेंस में शामिल होता है. इससे ParticipantSession रिसॉर्स भर जाता है और एक नया इवेंट ट्रिगर होता है. इसके बाद, subscribe या query तरीके का इस्तेमाल करके, इन इवेंट के बारे में जानकारी पाई जा सकती है.
इवेंट के लिए सदस्यता लेना
इवेंट की जानकारी रीयल टाइम में पाने के लिए, Meet ऐप्लिकेशन, Google Workspace Events API subscriptions.create तरीके का इस्तेमाल करता है. इससे, सभी तरह के इवेंट के लिए मीटिंग स्पेस को सब्सक्राइब किया जा सकता है. सदस्यता बनाने के बाद, Meet ऐप्लिकेशन को इवेंट मिलने शुरू हो सकते हैं.
दूसरी इमेज में, Meet ऐप्लिकेशन के पास मीटिंग स्पेस की चालू सदस्यता है. इसलिए, जब भी मीटिंग स्पेस में हिस्सा लेने वाले किसी व्यक्ति का सेशन बदलता है, तो ऐप्लिकेशन को एक इवेंट मिलता है. इसके बाद, Meet ऐप्लिकेशन किसी भी गतिविधि का जवाब रीयल टाइम में दे सकता है. जैसे, किसी व्यक्ति के चालू कॉन्फ़्रेंस में शामिल होने या उससे बाहर निकलने की जानकारी.
Google Workspace Events API का इस्तेमाल करके सदस्यताएं बनाने के बारे में जानने के लिए, Google Workspace Events API का दस्तावेज़ देखें.
हाल के इवेंट के लिए क्वेरी
मीटिंग के दौरान होने वाले इवेंट की जानकारी मिलने के बजाय, Meet ऐप्लिकेशन Meet REST API को कॉल करके, मीटिंग स्पेस से जुड़े हाल ही के इवेंट की सूची भी पा सकता है. ये इवेंट, मीटिंग में शामिल लोगों की गतिविधि से जुड़े होते हैं.
तीसरी इमेज में दिखाया गया है कि मीटिंग में हिस्सा लेने वाले सभी लोगों की सेशन गतिविधियां पूरी होने के बाद, Meet ऐप्लिकेशन, Meet REST API conferenceRecords.participants.participantSessions.list तरीके को कॉल करता है. Meet REST API, ParticipantSession संसाधनों की एक सूची दिखाता है. ये संसाधन, हर बदलाव को दिखाते हैं. इसके बाद, Meet ऐप्लिकेशन हाल ही की गतिविधि के आधार पर प्रोसेस कर सकता है या जवाब दे सकता है. जैसे, कॉन्फ़्रेंस में शामिल होने और छोड़ने वाले लोगों की सूची बनाना.
Meet REST API का इस्तेमाल करके इवेंट के बारे में क्वेरी करने के लिए, मीटिंग में शामिल सभी लोगों के सेशन की सूची देखें.
सीमाएं
- कॉन्फ़्रेंस में शामिल होने के लिए, कैलेंडर पर न्योता पाने वाले लोगों और अन्य मेहमानों को सिर्फ़ ये इवेंट दिखते हैं:
google.workspace.meet.conference.v2.startedऔरgoogle.workspace.meet.transcript.v2.fileGenerated.
मिलते-जुलते विषय
- Google Workspace Events API के बारे में खास जानकारी
- Google Workspace की सदस्यता बनाना
- Google Meet के इवेंट की सदस्यता लेना