Google Meet के मीटिंग स्पेस की खास जानकारी

Google Meet REST API की इमेज

इस गाइड में बताया गया है कि Google Meet REST API की मदद से, Google Meet के लिए मीटिंग कैसे बनाई और मैनेज की जा सकती हैं.

मीटिंग की जगह, किसी वर्चुअल जगह या स्थायी ऑब्जेक्ट (जैसे कि मीटिंग रूम) को दिखाती है. यहां कॉन्फ़्रेंस आयोजित किए जाते हैं. किसी स्पेस में एक समय में सिर्फ़ एक कॉन्फ़्रेंस चालू हो सकता है. मीटिंग स्पेस की मदद से, लोग एक-दूसरे से मिल सकते हैं और शेयर किए गए संसाधन ढूंढ सकते हैं.

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

मीटिंग की जगह से जुड़े तरीकों को कॉल करने का तरीका

मीटिंग स्पेस के तरीकों का इस्तेमाल करने के लिए, मीटिंग में शामिल लोगों की भूमिकाओं के बारे में यहां बताया गया है:

तरीका स्वामी पार्टी में शामिल लोग अन्य
endActiveConference x
get x x x
     सेटिंग के साथ x
     with active conference x x
patch x

Meet, मीटिंग स्पेस की पहचान कैसे करता है

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

मीटिंग स्पेस का पता लगाने और उसमें शामिल होने का तरीका इस टेबल में बताया गया है:

फ़ील्ड का नाम ब्यौरा
name स्पेस का नाम. {space} स्ट्रिंग, स्पेस के लिए संसाधन आइडेंटिफ़ायर है. इसका फ़ॉर्मैट spaces/{space} है. यह सर्वर से जनरेट किया गया यूनीक आईडी है. यह केस-सेंसिटिव होता है. उदाहरण के लिए, spaces/jQCFfuBOdN5z.
meetingCode स्पेस के नाम का उपनाम. {meetingCode} एक टाइप की जा सकने वाली, खास वर्ण स्ट्रिंग है. इसे अंग्रेज़ी के बड़े या छोटे किसी भी अक्षर में लिखा जा सकता है. इसे spaces/{meetingCode} के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, spaces/abc-mnop-xyz. इसमें ज़्यादा से ज़्यादा 128 वर्ण हो सकते हैं. यह meetingUri का हिस्सा है: https://meet.google.com/abc-mnop-xyz.
phoneAccess इस मीटिंग स्पेस में फ़ोन से शामिल होने के तरीके. phoneAccess ऑब्जेक्ट में, कॉन्फ़्रेंस में डायल करने के लिए ज़रूरी जानकारी होती है. इसमें मीटिंग स्पेस के लिए, क्षेत्र के हिसाब से फ़ोन नंबर और उस फ़ोन नंबर के लिए खास पिन कोड शामिल होता है. पिन में सिर्फ़ दशमलव वाले अंक होते हैं और इसकी लंबाई अलग-अलग हो सकती है. उदाहरण के लिए, "pin": 19707127300.

Meet के यूज़र इंटरफ़ेस (यूआई) की तरह ही, spaces संसाधन में डायल-इन नंबर का सीमित सेट शामिल होता है. मीटिंग स्पेस के लिए अन्य फ़ोन नंबर देखने के लिए, {meetingCode} को इस यूआरएल में जोड़ें: https://meet.google.com/tel/. उदाहरण के लिए, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess इस मीटिंग स्पेस के लिए, सेशन इनिशिएशन प्रोटोकॉल (एसआईपी) के ऐक्सेस के तरीके. एसआईपी पते से पता चलता है कि तीसरे पक्ष का वीडियो कॉन्फ़्रेंसिंग हार्डवेयर, Meet कॉन्फ़्रेंस को कैसे ढूंढ सकता है और उसमें कैसे शामिल हो सकता है. gatewaySipAccess ऑब्जेक्ट में यूआरआई और अंकों वाला ऐक्सेस कोड होता है. Meet, एसआईपी यूआरआई स्कीम के साथ काम करता है.

मीटिंग स्पेस को मैनेज करने के लिए, name फ़ील्ड के लिए इन वैल्यू का इस्तेमाल करें:

  • मीटिंग स्पेस के बारे में जानकारी पाने के लिए, spaces/{space} या उपनाम spaces/{meetingCode} का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, मीटिंग स्पेस पाना लेख पढ़ें.

  • मीटिंग स्पेस की जानकारी अपडेट करने के लिए, सिर्फ़ spaces/{space} का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, मीटिंग स्पेस अपडेट करना लेख पढ़ें.

  • मीटिंग स्पेस में चल रही कॉन्फ़्रेंस को खत्म करने के लिए, सिर्फ़ spaces/{space} का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, चालू कॉन्फ़्रेंस खत्म करना लेख पढ़ें.

मीटिंग स्पेस का लाइफ़साइकल

मीटिंग स्पेस, अपनी लाइफ़साइकल के दौरान कई स्थितियों से गुज़रता है. यहां दिए गए डायग्राम में, मीटिंग स्पेस के लाइफ़साइकल के हाई-लेवल चरणों को दिखाया गया है:

मीटिंग स्पेस का लाइफ़साइकल.
पहली इमेज. मीटिंग स्पेस का लाइफ़साइकल.

  1. spaces.create को कॉल करें. मीटिंग की जगह बन जाती है और दिखाए गए spaces ऑब्जेक्ट में meetingUri स्ट्रिंग होती है. इसके बाद, meetingUri को मीटिंग में हिस्सा लेने वाले लोगों के बीच बांट दिया जाता है.

  2. मीटिंग के लिए नए स्पेस के बारे में पोल करें. कॉन्फ़्रेंस की स्थिति की जांच करने के लिए, spaces.get तरीके को कॉल करें.

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

  3. कॉन्फ़्रेंस शुरू करें. जब मीटिंग में शामिल पहला व्यक्ति, मीटिंग स्पेस में मौजूद meetingUri पर क्लिक करता है, तब कॉन्फ़्रेंस शुरू होता है. activeConference ऑब्जेक्ट भर जाता है और activeConference.conferenceRecord स्ट्रिंग सेट हो जाती है.

  4. (ज़रूरी नहीं) कॉन्फ़्रेंस का डेटा पाना. चालू कॉन्फ़्रेंस के दौरान, कुछ conferenceRecord वैल्यू ऐक्सेस की जा सकती हैं. उदाहरण के लिए, कॉन्फ़्रेंस में शामिल सभी लोगों को देखने के लिए, conferenceRecords.participants.list तरीके को कॉल करें. कॉन्फ़्रेंस के बाद भी, इस जानकारी को 30 दिनों तक ऐक्सेस किया जा सकता है.

  5. (ज़रूरी नहीं) कॉन्फ़्रेंस खत्म करें. कॉन्फ़्रेंस के दौरान, मीटिंग का मालिक spaces.endActiveConference तरीके का इस्तेमाल करके, कॉन्फ़्रेंस में शामिल सभी लोगों के लिए चालू कॉन्फ़्रेंस को प्रोग्राम के हिसाब से खत्म कर सकता है.

  6. कॉन्फ़्रेंस खत्म हो जाता है. मीटिंग में हिस्सा लेने वाले सभी लोगों के मीटिंग छोड़ देने पर, कॉन्फ़्रेंस खत्म हो जाता है.

  7. कॉन्फ़्रेंस के बाद के आर्टफ़ैक्ट के लिए पोल. कॉन्फ़्रेंस खत्म हो गया है (STATE=ENDED), लेकिन आर्टफ़ैक्ट अब तक जनरेट नहीं हुए हैं. कॉन्फ़्रेंस के लिए startTime और endTime भी भरे जाते हैं. आपको आर्टफ़ैक्ट एंडपॉइंट को तब तक पोल करना होगा, जब तक आर्टफ़ैक्ट ऑब्जेक्ट STATE, FILE_GENERATED न पढ़ ले.

    पोल करने के बजाय, Meet इवेंट की सदस्यता ली जा सकती है, ताकि आपको पुश नोटिफ़िकेशन मिल सकें.

  8. कॉन्फ़्रेंस के बाद के आर्टफ़ैक्ट पाना. जनरेट होने के बाद, रिकॉर्डिंग और ट्रांसक्रिप्ट जैसे आर्टफ़ैक्ट वापस पाए जा सकते हैं. उदाहरण के लिए, रिकॉर्डिंग आईडी के हिसाब से रिकॉर्डिंग पाने के लिए, conferenceRecords.recordings.get तरीके को कॉल करें.

    तैयार होने के बाद, आर्टफ़ैक्ट ऑब्जेक्ट का यूआरआई भर दिया जाता है. साथ ही, इसे संसाधन ऑब्जेक्ट के हिस्से के तौर पर दिखाया जाता है.