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

Google Meet REST API की इमेज

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

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

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

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

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

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

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 संसाधन में डायल-इन नंबर का सीमित सेट शामिल होता है. मीटिंग स्पेस के लिए अन्य फ़ोन नंबर देखने के लिए, इस यूआरएल https://meet.google.com/tel/ में {meetingCode} जोड़ें. उदाहरण के लिए, 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 तरीके को कॉल करें.

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

  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 तरीके को कॉल करें.

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