Google Meet से इवेंट के जवाब देना

इस दस्तावेज़ में, Google Cloud Pub/Sub से Google Meet के इवेंट पाने और उनका जवाब देने का तरीका बताया गया है.

Meet इवेंट , Meet के किसी संसाधन में होने वाली गतिविधि या बदलाव को दिखाता है. जैसे, नई मीटिंग बनाना. इवेंट की मदद से, यह समझा जा सकता है कि क्या हुआ और फिर कार्रवाई की जा सकती है. इसके अलावा, अपने उपयोगकर्ताओं के लिए काम का जवाब दिया जा सकता है.

यहां कुछ उदाहरण दिए गए हैं, जिनसे पता चलता है कि इवेंट का इस्तेमाल कैसे किया जा सकता है:

  • किसी मीटिंग में होने वाले बदलावों को देखना और उनका जवाब देना. जैसे, मीटिंग कब शुरू या खत्म हुई.

  • कानूनी या ट्रेनिंग के मकसद से, यह ट्रैक करना कि मीटिंग में कौन शामिल हुआ.

  • मीटिंग की ट्रांसक्रिप्ट सुनना, ताकि फ़ाइल के कॉन्टेंट को पार्स किया जा सके और सीआरएम या डेटाबेस में लॉग किया जा सके.

इवेंट कैसे काम करते हैं

Google Meet में कुछ भी होने पर, Google Meet REST API का कोई संसाधन बनाया या अपडेट किया जाता है. Meet, इवेंट का इस्तेमाल करके आपके ऐप्लिकेशन को इस बारे में जानकारी देता है कि किस तरह की गतिविधि हुई और Meet REST API का कौनसे संसाधन पर इसका असर पड़ा.

मीटिंग की नई जगह से इवेंट ट्रिगर होने का उदाहरण.
पहली इमेज. कोई उपयोगकर्ता मीटिंग के लिए जगह बनाता है. इससे a Space संसाधन बनता है. इसके बाद, Meet एक इवेंट बनाता है, जिसमें मीटिंग के लिए बनाई गई नई जगह के बारे में डेटा होता है.

Meet, इवेंट को टाइप के हिसाब से कैटगरी में बांटता है. इवेंट के टाइप की मदद से, सिर्फ़ उस जानकारी को फ़िल्टर किया जा सकता है और पाया जा सकता है जिसकी आपको ज़रूरत है. साथ ही, एक जैसी गतिविधियों को एक ही तरीके से मैनेज किया जा सकता है.

यहां दिए गए उदाहरण से पता चलता है कि Meet में किसी गतिविधि का असर, Meet REST API के किसी संसाधन पर कैसे पड़ता है. साथ ही, आपके Meet ऐप्लिकेशन को किस तरह का इवेंट मिलता है:

गतिविधि Meet REST API का संसाधन इवेंट किस तरह का है
कोई उपयोगकर्ता, मीटिंग के लिए बनाई गई जगह में शामिल होता है. एक ConferenceRecord संसाधन बनाया जाता है. कॉन्फ़्रेंस का नया रिकॉर्ड

Google Meet से इवेंट का डेटा पाना

इवेंट का डेटा पाने के लिए, आपका ऐप्लिकेशन इनमें से कोई एक काम कर सकता है:

यहां दी गई टेबल में, इवेंट की सदस्यता लेने और उनके लिए क्वेरी करने के बीच का अंतर और वजहें बताई गई हैं:

इवेंट की सदस्यता लेना डेटा से जुड़ी क्वेरी करना
इस्तेमाल के उदाहरण
  • इवेंट को रीयल टाइम में प्रोसेस करना या उनका जवाब देना.
  • अपने ऐप्लिकेशन की परफ़ॉर्मेंस बेहतर बनाने के लिए, संसाधनों में होने वाले बदलावों पर नज़र रखना.
  • मैन्युअल तरीके से डेटा पाना.
  • Meet से सारा डेटा फ़ेच करना (आउटेज या सदस्यता के चालू न होने की वजह से).
एपीआई Google Workspace Events API Meet REST API
इवेंट का स्रोत कॉन्फ़्रेंस का रिकॉर्ड और उपयोगकर्ता जगह और कॉन्फ़्रेंस का रिकॉर्ड
कौनसे इवेंट काम करते हैं कॉन्फ़्रेंस का रिकॉर्ड

इस्तेमाल किए जा सकने वाले इवेंट के टाइप की सूची देखने के लिए, सदस्यताएं बनाने के लिए इवेंट के टाइप Google Workspace Events API के दस्तावेज़ में देखें. 		जगह और कॉन्फ़्रेंस का रिकॉर्ड

इस्तेमाल किए जा सकने वाले एंडपॉइंट की सूची देखने के लिए, Meet REST API के दस्तावेज़ में, Space संसाधन और ConferenceRecord संसाधन देखें.
इवेंट का फ़ॉर्मैट Google Cloud Pub/Sub का कोई मैसेज, जिसे CloudEvent की खास जानकारी के मुताबिक फ़ॉर्मैट किया गया हो. ज़्यादा जानकारी के लिए, Google Workspace के इवेंट का स्ट्रक्चर देखें. Meet REST API का कोई संसाधन (Space और ConferenceRecord)
इवेंट का डेटा Base64 में कोड में बदली गई स्ट्रिंग, जिसमें संसाधन का डेटा हो भी सकता है और नहीं भी. पेलोड के उदाहरण देखने के लिए, इवेंट का डेटा देखें. JSON पेलोड, जिसमें संसाधन का डेटा होता है. पेलोड का उदाहरण देखने के लिए, रेफ़रंस दस्तावेज़ में ConferenceRecord संसाधन देखें.

उदाहरण: मीटिंग के लिए बनाई गई जगह में शामिल लोगों के बारे में इवेंट पाना

इस उदाहरण में, Meet का कोई ऐप्लिकेशन, मीटिंग के लिए बनाई गई जगह में शामिल लोगों में होने वाले बदलावों के बारे में जानकारी पाना चाहता है. मीटिंग के लिए बनाई गई जगह में, कोई व्यक्ति चालू कॉन्फ़्रेंस में शामिल होता है. इससे ParticipantSession संसाधन भर जाता है और एक नया इवेंट ट्रिगर होता है. इसके बाद, सदस्यता लेने या क्वेरी करने के तरीके का इस्तेमाल करके, इन इवेंट के बारे में जानकारी पाई जा सकती है.

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

रीयल टाइम में इवेंट पाने के लिए, Meet ऐप्लिकेशन, Google Workspace Events API subscriptions.create तरीके को कॉल करता है, ताकि सभी तरह के इवेंट के लिए, मीटिंग के लिए बनाई गई जगह की सदस्यता ली जा सके. सदस्यता बनाने के बाद, Meet ऐप्लिकेशन को इवेंट मिलने लगते हैं.

Meet ऐप्लिकेशन, Google Workspace Events API का इस्तेमाल करके मीटिंग में शामिल होने वाले लोगों के इवेंट की सदस्यता लेता है.
दूसरी इमेज. Google Workspace Events API का इस्तेमाल करके, Meet ऐप्लिकेशन को सदस्यता के ज़रिए, शामिल लोगों के इवेंट मिलते हैं.

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

Google Workspace Events API का इस्तेमाल करके, सदस्यताएं बनाने के बारे में जानने के लिए, Google Workspace Events API का दस्तावेज़ देखें.

हाल ही के इवेंट के लिए क्वेरी करना

Meet ऐप्लिकेशन, इवेंट होने पर उन्हें पाने के बजाय, Meet REST API को कॉल करके, मीटिंग के लिए बनाई गई जगह के हाल ही के उन इवेंट की सूची भी पा सकता है जो शामिल लोगों की गतिविधि से जुड़े हैं.

Meet ऐप्लिकेशन, Meet REST API का इस्तेमाल करके मीटिंग में हिस्सा लेने वाले लोगों के इवेंट के बारे में क्वेरी करता है.
तीसरी इमेज. Meet ऐप्लिकेशन, Meet REST API का इस्तेमाल करके, मीटिंग के लिए बनाई गई जगह के इवेंट के लिए क्वेरी करके, हाल के इवेंट पाता है.

तीसरी इमेज में, Meet ऐप्लिकेशन, शामिल लोगों के सेशन की सभी गतिविधियां होने के बाद, Meet REST API conferenceRecords.participants.participantSessions.list तरीके को कॉल करता है. Meet REST API, ParticipantSession संसाधनों की एक सूची दिखाता है. इसमें हर बदलाव के बारे में जानकारी होती है. इसके बाद, Meet ऐप्लिकेशन, हाल ही की गतिविधि के आधार पर प्रोसेस कर सकता है या जवाब दे सकता है. जैसे, कॉन्फ़्रेंस में शामिल होने और उससे बाहर जाने वाले लोगों की सूची बनाना.

Meet REST API का इस्तेमाल करके, इवेंट के लिए क्वेरी करने के बारे में जानने के लिए, शामिल लोगों के सभी सेशन की सूची देखना लेख पढ़ें.

सीमाएं
  • Calendar के न्योते पाने वाले लोगों और कॉन्फ़्रेंस में न्योता पाने वाले अन्य लोग, सिर्फ़ ये इवेंट पा सकते हैं: google.workspace.meet.conference.v2.started और google.workspace.meet.transcript.v2.fileGenerated.