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

spaces.create तरीके का इस्तेमाल करके, Google Meet स्पेस बनाना

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

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

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

मीटिंग स्पेस के तरीके से जुड़ी अनुमतियां

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

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

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

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} का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, चालू कॉन्फ़्रेंस खत्म करना लेख पढ़ें.

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

इस्तेमाल के उदाहरण के हिसाब से OAuth के दायरे

Meet से पुष्टि करें गाइड में, Meet REST API के सभी स्कोप और पुष्टि करने की संवेदनशीलता के टियर की सूची दी गई है. हालांकि, मीटिंग स्पेस के साथ काम करते समय, स्कोप से जुड़ी ज़रूरी शर्तें अलग-अलग होती हैं. ये इस बात पर निर्भर करती हैं कि स्पेस आपके ऐप्लिकेशन ने बनाया है या किसी बाहरी ऐप्लिकेशन (जैसे, Google Calendar) ने.

यहां दी गई टेबल में, मीटिंग स्पेस के इस्तेमाल के खास उदाहरण के आधार पर, ज़रूरी OAuth स्कोप के बारे में बताया गया है:

इस्तेमाल का उदाहरण स्कोप कोड
दूसरे ऐप्लिकेशन से बनाए गए स्पेस के लिए, आर्टफ़ैक्ट अपने-आप जनरेट होने की सुविधा सेट अप करें. https://www.googleapis.com/auth/meetings.space.settings
अन्य ऐप्लिकेशन से बनाई गई कॉन्फ़्रेंस के आर्टफ़ैक्ट पाना या उनकी सूची बनाना. https://www.googleapis.com/auth/meetings.space.readonly
तीसरे पक्ष के ऐप्लिकेशन से बनाए गए मीटिंग स्पेस की, मीटिंग से पहले की अन्य सेटिंग पाएं या उनकी सूची बनाएं. https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
मीटिंग की उन सभी जगहों की सेटिंग को पढ़ता और उनमें बदलाव करता है जिन्हें कोई उपयोगकर्ता Calendar जैसे किसी अन्य ऐप्लिकेशन से ऐक्सेस कर सकता है. https://www.googleapis.com/auth/meetings.space.settings

इस्तेमाल किए जा सकने वाले सभी स्कोप और उनके अनुमति से जुड़े संवेदनशीलता स्तरों की पूरी सूची देखने के लिए, Meet REST API के स्कोप देखें.

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

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

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

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

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