इस दस्तावेज़ में, Google Meet REST API का इस्तेमाल करके, कॉन्फ़्रेंस से जनरेट हुए अलग-अलग मीटिंग आर्टफ़ैक्ट के बारे में जानकारी पाने का तरीका बताया गया है.
आर्टफ़ैक्ट, Google Meet की ओर से जनरेट की गई कोई फ़ाइल या डेटा होता है. यह डेटा, कॉन्फ़्रेंस के जवाब में जनरेट होता है. इसमें वीडियो रिकॉर्डिंग और अन्य आर्टफ़ैक्ट शामिल हैं. जैसे, ट्रांसक्रिप्ट.
आर्टफ़ैक्ट जनरेट करने के लिए, लोगों को कॉन्फ़्रेंस खत्म होने से पहले, Meet में उन्हें कॉन्फ़िगर करना होगा. ज़्यादा जानकारी के लिए, अपने-आप जनरेट होने वाले आर्टफ़ैक्ट मैनेज करना लेख पढ़ें.
ट्रांसक्रिप्ट, रिकॉर्डिंग से अलग होती हैं. ट्रांसक्रिप्ट जनरेट करने के लिए, आपको मीटिंग रिकॉर्ड करने की ज़रूरत नहीं होती. अगर मीटिंग में हिस्सा लेने वाले सभी लोग मीटिंग छोड़ देते हैं, तो ट्रांसक्रिप्ट की सुविधा अपने-आप बंद हो जाती है. ज़्यादा जानकारी के लिए, वीडियो मीटिंग रिकॉर्ड करना और Google Meet में ट्रांसक्रिप्ट जनरेट करने की सुविधा इस्तेमाल करना लेख पढ़ें.
आर्टफ़ैक्ट वापस पाना
अगर आप मीटिंग स्पेस के मालिक हैं या उसमें शामिल हैं, तो recordings, transcripts, transcripts.entries, और smart notes संसाधनों पर get और list तरीकों का इस्तेमाल करके, आर्टफ़ैक्ट वापस पाए जा सकते हैं. ज़्यादा जानकारी के लिए, यहां दिए गए सेक्शन देखें.
उपयोगकर्ता के क्रेडेंशियल की मदद से पुष्टि करने और अनुमति देने पर, Meet ऐप्लिकेशन को उपयोगकर्ता का डेटा ऐक्सेस करने की अनुमति मिलती है. साथ ही, वे पुष्टि किए गए उपयोगकर्ता की ओर से कार्रवाइयां कर सकते हैं. डोमेन-वाइड डेलिगेशन का इस्तेमाल करके पुष्टि करने से, किसी ऐप्लिकेशन के सेवा खाते को अपने उपयोगकर्ताओं का डेटा ऐक्सेस करने की अनुमति दी जा सकती है. इसके लिए, हर उपयोगकर्ता से सहमति लेने की ज़रूरत नहीं होती.
आर्टफ़ैक्ट बनाए रखने की अवधि
कॉन्फ़्रेंस खत्म होने के बाद, Meet रिकॉर्डिंग और ट्रांसक्रिप्ट को मीटिंग के आयोजक के Google Drive में सेव करता है. डिफ़ॉल्ट रूप से, Meet के आर्टफ़ैक्ट को Drive के नियमों के मुताबिक बनाए रखा जाता है.
मीटिंग खत्म होने के 30 दिनों के बाद, Meet REST API से मिली ट्रांसक्रिप्ट की एंट्री मिटा दी जाती हैं.
Google Vault में Meet के लिए तय किए गए निजी डेटा के रखरखाव के नियमों का इस्तेमाल करके, Meet आर्टफ़ैक्ट के रखरखाव को अलग से मैनेज किया जा सकता है. ज़्यादा जानकारी के लिए, Vault की मदद से Google Meet का डेटा बनाए रखना लेख पढ़ें.
रिकॉर्डिंग
यहां दिए गए सेक्शन में, कॉन्फ़्रेंस रिकॉर्ड में रिकॉर्डिंग की जानकारी पाने का तरीका बताया गया है.
रिकॉर्डिंग फ़ाइल जनरेट होने के बाद, Meet के पास रिकॉर्डिंग आईडी का ऐक्सेस होता है. ऐसा हो सकता है कि कोई उपयोगकर्ता Google Drive से रिकॉर्डिंग फ़ाइल मिटा दे, लेकिन Meet में अब भी यूनीक नाम दिखे.
recordings संसाधन में, DriveDestination और State, दोनों ऑब्जेक्ट शामिल होते हैं.
DriveDestination ऑब्जेक्ट में, Drive में एक्सपोर्ट की गई जगह की जानकारी होती है. यहां रिकॉर्डिंग को MP4 फ़ाइल के तौर पर सेव किया जाता है. रिकॉर्डिंग डाउनलोड करने या उसे ब्राउज़र में वापस चलाने के लिए, ऑब्जेक्ट की exportUri फ़ील्ड वैल्यू का इस्तेमाल करें. अगर आपको Google Drive API के बारे में जानकारी है, तो file फ़ील्ड की वैल्यू, files रिसोर्स में मौजूद id फ़ील्ड से जुड़ी होती है. ज़्यादा जानकारी के लिए, फ़ाइलें डाउनलोड और एक्सपोर्ट करना लेख पढ़ें.
State ऑब्जेक्ट में रिकॉर्डिंग सेशन की स्थिति होती है. इससे यह क्वेरी की जा सकती है कि रिकॉर्डिंग शुरू हुई है या नहीं, रिकॉर्डिंग खत्म हो गई है, लेकिन रिकॉर्डिंग फ़ाइल तैयार नहीं है या रिकॉर्डिंग फ़ाइल जनरेट हो गई है और डाउनलोड करने के लिए तैयार है.
किसी रिकॉर्डिंग के बारे में जानकारी पाना
किसी खास रिकॉर्डिंग के बारे में जानकारी पाने के लिए, name पाथ पैरामीटर के साथ recordings रिसॉर्स पर get तरीके का इस्तेमाल करें. अगर आपको रिकॉर्डिंग का नाम नहीं पता है, तो list तरीके का इस्तेमाल करके, सभी रिकॉर्डिंग के नाम देखे जा सकते हैं.
यह तरीका, recordings संसाधन का एक इंस्टेंस दिखाता है.
यहां दिए गए कोड सैंपल में, किसी रिकॉर्डिंग को वापस पाने का तरीका बताया गया है:
Java
Node.js
Python
रिकॉर्डिंग के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद किसी खास रिकॉर्डिंग आईडी का नाम डालें.
सभी रिकॉर्डिंग की सूची बनाना
कॉन्फ़्रेंस रिकॉर्ड में मौजूद सभी रिकॉर्डिंग के बारे में जानकारी पाने के लिए, parent पाथ पैरामीटर के साथ recordings संसाधन पर list तरीके का इस्तेमाल करें. फ़ॉर्मैट conferenceRecords/{conferenceRecord} है.
यह तरीका, कॉन्फ़्रेंस की रिकॉर्डिंग की सूची दिखाता है. इस सूची को startTime के हिसाब से बढ़ते हुए क्रम में लगाया जाता है. यह सूची, recordings संसाधन के इंस्टेंस के तौर पर दिखती है. पेज का साइज़ बदलने के लिए, पेज नंबर के हिसाब से डेटा दिखाने की सुविधा को पसंद के मुताबिक बनाना लेख पढ़ें.
यहां दिए गए कोड सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में मौजूद सभी रिकॉर्डिंग की सूची बनाने का तरीका बताया गया है:
Java
Node.js
Python
पैरंट वैल्यू को कॉन्फ़्रेंस रिकॉर्ड के नाम से बदलें.
ट्रांसक्रिप्ट की सुविधा
कॉन्फ़्रेंस रिकॉर्ड में कॉन्फ़्रेंस की ट्रांसक्रिप्ट के बारे में जानकारी पाने का तरीका यहां बताया गया है.
ट्रांसक्रिप्ट का डेटा जनरेट होने के बाद, Meet के पास ट्रांसक्रिप्ट आईडी का ऐक्सेस होता है. ऐसा हो सकता है कि कोई उपयोगकर्ता Drive से ट्रांसक्रिप्ट फ़ाइल मिटा दे, लेकिन Meet में अब भी यूनीक नाम दिखे.
transcripts संसाधन में DocsDestination और State, दोनों ऑब्जेक्ट शामिल होते हैं.
DocsDestination ऑब्जेक्ट में, Drive में एक्सपोर्ट की गई फ़ाइल की जगह की जानकारी होती है. इसी जगह पर, Google दस्तावेज़ की ट्रांसक्रिप्ट फ़ाइल सेव की जाती है. कॉन्टेंट फ़ेच करने या ब्राउज़र में ट्रांसक्रिप्ट ब्राउज़ करने के लिए, ऑब्जेक्ट की exportUri फ़ील्ड वैल्यू का इस्तेमाल करें. अगर आपको Google Docs API के बारे में जानकारी है, तो document फ़ील्ड की वैल्यू, documents रिसोर्स में मौजूद documentId से मेल खाती है.
State ऑब्जेक्ट में, ट्रांसक्रिप्ट सेशन की स्थिति होती है. इससे यह क्वेरी की जा सकती है कि ट्रांसक्रिप्ट सेशन शुरू हुआ है या नहीं. साथ ही, यह भी क्वेरी की जा सकती है कि ट्रांसक्रिप्ट सेशन खत्म हो गया है, लेकिन ट्रांसक्रिप्ट फ़ाइल तैयार नहीं है या ट्रांसक्रिप्ट फ़ाइल जनरेट हो गई है और डाउनलोड करने के लिए तैयार है.
ट्रांसक्रिप्ट के बारे में जानकारी पाना
किसी खास ट्रांसक्रिप्ट के बारे में जानकारी पाने के लिए, name पाथ पैरामीटर के साथ transcripts रिसॉर्स पर get तरीके का इस्तेमाल करें. अगर आपको ट्रांसक्रिप्ट का नाम नहीं पता है, तो list तरीके का इस्तेमाल करके, सभी ट्रांसक्रिप्ट के नाम की सूची बनाएं.
यह तरीका, transcripts संसाधन का एक इंस्टेंस दिखाता है.
यहां दिए गए कोड सैंपल में, किसी खास ट्रांसक्रिप्ट को वापस पाने का तरीका बताया गया है:
Java
Node.js
Python
ट्रांसक्रिप्ट के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद किसी खास ट्रांसक्रिप्ट आईडी का नाम डालें.
सभी ट्रांसक्रिप्ट की सूची बनाना
कॉन्फ़्रेंस रिकॉर्ड में मौजूद सभी ट्रांसक्रिप्ट के बारे में जानकारी पाने के लिए, list तरीके का इस्तेमाल करें. इसके लिए, parent पाथ पैरामीटर के साथ transcripts संसाधन का इस्तेमाल करें. फ़ॉर्मैट conferenceRecords/{conferenceRecord} है.
यह तरीका, कॉन्फ़्रेंस की ट्रांसक्रिप्ट की सूची दिखाता है. इस सूची को startTime के हिसाब से बढ़ते क्रम में लगाया जाता है. यह सूची, transcripts संसाधन के इंस्टेंस के तौर पर दिखती है. पेज का साइज़ बदलने के लिए, पेज नंबर के हिसाब से डेटा दिखाने की सुविधा को पसंद के मुताबिक बनाना लेख पढ़ें.
नीचे दिए गए कोड सैंपल में, कॉन्फ़्रेंस रिकॉर्डिंग में मौजूद सभी ट्रांसक्रिप्ट की सूची बनाने का तरीका बताया गया है:
Java
Node.js
Python
पैरंट वैल्यू को कॉन्फ़्रेंस रिकॉर्ड के नाम से बदलें.
ट्रांसक्रिप्ट की एंट्री
यहां दिए गए सेक्शन में, कॉन्फ़्रेंस की ट्रांसक्रिप्ट वाले सेशन के दौरान, हर प्रतिभागी के भाषण को ट्रांसक्रिप्ट एंट्री के तौर पर पाने का तरीका बताया गया है.
ट्रांसक्रिप्ट एंट्री में, मीटिंग में शामिल व्यक्ति की आवाज़ को टेक्स्ट में बदला जाता है. इसमें ज़्यादा से ज़्यादा 10,000 शब्द हो सकते हैं. बोले गए टेक्स्ट languageCode (उदाहरण के लिए, en-US) को भी IETF BCP 47 सिंटैक्स के तौर पर शामिल किया जाता है.
ट्रांसक्रिप्ट की हर एंट्री, कॉन्फ़्रेंस में मौजूद participant नाम से जुड़ी होती है. मीटिंग में शामिल होने वाले व्यक्ति की जानकारी पाने के लिए, मीटिंग में शामिल होने वाले किसी व्यक्ति के बारे में जानकारी पाना लेख पढ़ें.
कॉन्फ़्रेंस खत्म होने के 30 दिनों तक, ट्रांसक्रिप्ट एंट्री का डेटा उपलब्ध रहता है.
ध्यान दें कि Meet REST API से मिली ट्रांसक्रिप्ट की एंट्री, Docs की ट्रांसक्रिप्ट फ़ाइल में मौजूद ट्रांसक्रिप्ट से मेल नहीं खा सकती हैं. ऐसा तब होता है, जब ट्रांसक्रिप्ट फ़ाइल जनरेट होने के बाद उसमें बदलाव किया जाता है.
ट्रांसक्रिप्ट की किसी एंट्री के बारे में जानकारी पाना
किसी खास ट्रांसक्रिप्ट एंट्री के बारे में जानकारी पाने के लिए, name पाथ पैरामीटर के साथ transcripts.entries रिसॉर्स पर get तरीके का इस्तेमाल करें. अगर आपको ट्रांसक्रिप्ट एंट्री का नाम नहीं पता है, तो list तरीके का इस्तेमाल करके, ट्रांसक्रिप्ट एंट्री के सभी नामों की सूची बनाएं.
यह तरीका, transcripts.entries संसाधन का एक इंस्टेंस दिखाता है.
यहां दिए गए कोड सैंपल में, किसी खास ट्रांसक्रिप्ट एंट्री को वापस पाने का तरीका बताया गया है:
Java
Node.js
Python
ट्रांसक्रिप्ट एंट्री के नाम की जगह, ट्रांसक्रिप्ट में मौजूद किसी खास ट्रांसक्रिप्ट एंट्री का आईडी डालें.
ट्रांसक्रिप्ट की सभी एंट्री की सूची बनाना
किसी ट्रांसक्रिप्ट में मौजूद सभी ट्रांसक्रिप्ट एंट्री के बारे में जानकारी पाने के लिए, transcripts.entries संसाधन पर list तरीके का इस्तेमाल करें. इसके लिए, parent पाथ पैरामीटर का इस्तेमाल करें. फ़ॉर्मैट conferenceRecords/{conferenceRecord}/transcripts/{transcript} है.
यह तरीका, हर कॉन्फ़्रेंस ट्रांसक्रिप्ट के हिसाब से स्ट्रक्चर्ड ट्रांसक्रिप्ट एंट्री की सूची दिखाता है. इसे startTime के हिसाब से बढ़ते क्रम में लगाया जाता है. यह transcripts.entries संसाधन के उदाहरण के तौर पर दिखता है. पेज का साइज़ बदलने के लिए, पेज नंबर डालने की सुविधा को पसंद के मुताबिक बनाएं लेख पढ़ें.
यहां दिए गए कोड सैंपल में, किसी ट्रांसक्रिप्ट में मौजूद सभी ट्रांसक्रिप्ट एंट्री की सूची बनाने का तरीका बताया गया है:
Java
Node.js
Python
कॉन्फ़्रेंस रिकॉर्ड और ट्रांसक्रिप्ट के नाम से पैरंट वैल्यू बदलें.
स्मार्ट नोट
यहां दिए गए सेक्शन में, कॉन्फ़्रेंस रिकॉर्ड में कॉन्फ़्रेंस के स्मार्ट नोट के बारे में जानकारी पाने का तरीका बताया गया है.
स्मार्ट नोट का डेटा जनरेट होने के बाद, Meet के पास स्मार्ट नोट आईडी का ऐक्सेस होता है. ऐसा हो सकता है कि कोई उपयोगकर्ता Drive से स्मार्ट नोट वाली फ़ाइल मिटा दे, लेकिन Meet में अब भी उसका यूनीक नाम दिखे.
smartNotes संसाधन में, State ऑब्जेक्ट शामिल होता है.
इस ऑब्जेक्ट में, स्मार्ट नोट सेशन का स्टेटस होता है. इससे यह क्वेरी की जा सकती है कि स्मार्ट नोट का सेशन शुरू हो गया है या नहीं. यह भी क्वेरी की जा सकती है कि स्मार्ट नोट का सेशन खत्म हो गया है, लेकिन स्मार्ट नोट की फ़ाइल तैयार नहीं है. इसके अलावा, यह भी क्वेरी की जा सकती है कि स्मार्ट नोट की फ़ाइल जनरेट हो गई है और डाउनलोड करने के लिए तैयार है.
smartNotes संसाधन में DocsDestination ऑब्जेक्ट टाइप भी शामिल है. इस ऑब्जेक्ट में, Drive में एक्सपोर्ट की गई फ़ाइल की जगह की जानकारी होती है. इस जगह पर, Google दस्तावेज़ के स्मार्ट नोट वाली फ़ाइल सेव की जाती है. कॉन्टेंट फ़ेच करने या ब्राउज़र में स्मार्ट नोट ब्राउज़ करने के लिए, ऑब्जेक्ट के exportUri फ़ील्ड वैल्यू का इस्तेमाल करें. अगर आपको Google Docs API के बारे में जानकारी है, तो document फ़ील्ड की वैल्यू, documents रिसोर्स में मौजूद documentId से मेल खाती है.
get और list तरीकों का इस्तेमाल करके, स्मार्ट नोट मैनेज किए जा सकते हैं.
स्मार्ट नोट के बारे में जानकारी पाना
किसी स्मार्ट नोट फ़ाइल के बारे में जानकारी पाने के लिए, get तरीके का इस्तेमाल करें. इसके लिए, smartNotes रिसोर्स के साथ name पाथ पैरामीटर का इस्तेमाल करें. अगर आपको स्मार्ट नोट का नाम नहीं पता है, तो list तरीके का इस्तेमाल करके, स्मार्ट नोट की सभी फ़ाइलों की सूची देखी जा सकती है.
यह तरीका, smartNotes संसाधन का एक इंस्टेंस दिखाता है.
सभी स्मार्ट नोट की सूची बनाना
कॉन्फ़्रेंस रिकॉर्ड में मौजूद सभी स्मार्ट नोट फ़ाइलों के बारे में जानकारी पाने के लिए, smartNotes संसाधन पर list तरीके का इस्तेमाल करें. इसके लिए, parent पाथ पैरामीटर का इस्तेमाल करें. फ़ॉर्मैट conferenceRecords/{conferenceRecord} है.
यह तरीका, कॉन्फ़्रेंस के स्मार्ट नोट की फ़ाइलों की सूची दिखाता है. इन्हें startTime के हिसाब से बढ़ते क्रम में लगाया जाता है. यह सूची, smartNotes संसाधन के उदाहरण के तौर पर दिखती है. पेज का साइज़ बदलने के लिए, पेज नंबर डालने की सुविधा को पसंद के मुताबिक बनाएं लेख पढ़ें.
पेज पर नंबर डालने की सुविधा को पसंद के मुताबिक बनाना
रिकॉर्डिंग, ट्रांसक्रिप्ट, और ट्रांसक्रिप्ट एंट्री के पेज नंबर को पसंद के मुताबिक बनाने के लिए, यहां दिए गए क्वेरी पैरामीटर पास करें:
pageSize: लौटाए जाने वाले प्रॉडक्ट की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 आइटम दिखाए जाते हैं. इसकी ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है. 100 से ज़्यादा वैल्यू अपने-आप 100 में बदल जाती हैं.pageToken: यह एक पेज टोकन है, जो सूची बनाने के लिए किए गए पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह टोकन दें.