इस गाइड में, Google Meet REST API का इस्तेमाल करके, पिछली किसी कॉन्फ़्रेंस में हिस्सा लेने वाले लोगों या चालू कॉन्फ़्रेंस में शामिल लोगों की जानकारी पाने का तरीका बताया गया है. इसमें उनके सेशन की जानकारी भी शामिल है.
एक प्रतिभागी वह व्यक्ति होता है जो किसी कॉल में
शामिल होता है या जो कंपैनियन
मोड का उपयोग करता है, दर्शक के रूप में देखता है, या
कॉल से कनेक्ट किया गया एक रूम डिवाइस होता है. हर व्यक्ति के लिए,
participants
नाम का एक संसाधन होता है.
कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति का सेशन, हर उस व्यक्ति-डिवाइस के पेयर के लिए बनाया गया एक यूनीक सेशन आईडी होता है जो किसी कॉल में शामिल होता है. हर सेशन के लिए,
participantSessions
नाम का एक संसाधन होता है. अगर कोई व्यक्ति-डिवाइस का पेयर, एक ही कॉल में कई बार शामिल होता है, तो हर बार उसे यूनीक सेशन आईडी असाइन किए जाते हैं.
अगर आप मीटिंग स्पेस के मालिक या उसमें हिस्सा लेने वाले व्यक्ति हैं, तो हिस्सा लेने वाले लोगों के रिकॉर्ड वापस पाने के लिए, आप participants और participantSessions, दोनों संसाधनों पर get और list तरीकों को कॉल कर सकते हैं.
उपयोगकर्ता क्रेडेंशियल की मदद से पुष्टि करने और अनुमति देने पर, Google Meet के ऐप्लिकेशन, उपयोगकर्ता का डेटा ऐक्सेस कर सकते हैं. साथ ही, पुष्टि किए गए उपयोगकर्ता की ओर से कार्रवाइयां कर सकते हैं. डोमेन-वाइड डेलिगेशन की मदद से पुष्टि करने पर, किसी ऐप्लिकेशन के सेवा खाते को आपके उपयोगकर्ताओं के डेटा को ऐक्सेस करने की अनुमति दी जा सकती है . इसके लिए, हर उपयोगकर्ता से अनुमति लेने की ज़रूरत नहीं होती.
कॉन्फ़्रेंस में हिस्सा लेने वाले लोग
इन सेक्शन में, कॉन्फ़्रेंस के रिकॉर्ड में हिस्सा लेने वाले लोगों के बारे में जानकारी पाने का तरीका बताया गया है.
participants
संसाधन, user फ़ील्ड के साथ जुड़ता है. कोई user इनमें से कोई एक ऑब्जेक्ट हो सकता है:
A
signedinUserइनमें से कोई एक हो सकता है:कोई व्यक्ति जो निजी कंप्यूटर, मोबाइल डिवाइस या कंपैनियन मोड से शामिल हो रहा है.
कॉन्फ़्रेंस रूम के डिवाइसों से इस्तेमाल किया जाने वाला कोई रोबोट खाता.
anonymousUserकोई ऐसा उपयोगकर्ता होता है जिसकी पहचान नहीं की जा सकती और जिसने किसी Google खाते में साइन इन नहीं किया है.A
phoneUserकोई ऐसा उपयोगकर्ता होता है जो किसी फ़ोन से कॉल कर रहा है. इस उपयोगकर्ता की पहचान नहीं की जा सकती, क्योंकि उसने किसी Google खाते से साइन इन नहीं किया है.
ध्यान दें कि तीनों ऑब्जेक्ट, displayName दिखाते हैं. हालांकि, signedinUser एक यूनीक user आईडी भी दिखाता है, जो Admin SDK API और People API के साथ इंटरऑपरेबल होता है. फ़ॉर्मैट: users/{user}. People API के साथ user
आईडी का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, People API की मदद से, कॉन्फ़्रेंस में हिस्सा लेने वाले लोगों की जानकारी पाना
लेख पढ़ें.
कॉन्फ़्रेंस में हिस्सा लेने वाले किसी व्यक्ति के बारे में जानकारी पाना
किसी खास कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के बारे में जानकारी पाने के लिए, get तरीके का इस्तेमाल करें participants संसाधन पर. name पाथ पैरामीटर को conferenceRecords/{conferenceRecord}/participants/{participantRecord} फ़ॉर्मैट में सेट करें.
अगर आपको कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति का नाम नहीं पता है, तो हिस्सा लेने वाले सभी लोगों के नाम की सूची
देखी जा सकती है list तरीके का इस्तेमाल करके.
यह तरीका, participants संसाधन के इंस्टेंस के तौर पर, हिस्सा लेने वाले व्यक्ति का डेटा दिखाता है.
यहां दिए गए कोड सैंपल में, कॉन्फ़्रेंस में हिस्सा लेने वाले किसी व्यक्ति की जानकारी पाने का तरीका बताया गया है:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN की जगह, वह ऐक्सेस टोकन डालें जो एपीआई का ऐक्सेस देता है.
इनकी जगह ये डालें:
- कॉन्फ़्रेंस रिकॉर्ड के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस के खास आईडी का नाम.
- कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के खास आईडी का नाम.
कॉन्फ़्रेंस में हिस्सा लेने वाले सभी लोगों की सूची देखना
कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले सभी लोगों के बारे में जानकारी पाने के लिए, list
तरीके का इस्तेमाल
participants
संसाधन पर करें. parent पाथ पैरामीटर को conferenceRecords/{conferenceRecord} फ़ॉर्मैट में सेट करें.
यह तरीका, participants संसाधन के इंस्टेंस के तौर पर, कॉन्फ़्रेंस में हिस्सा लेने वाले लोगों की सूची दिखाता है. इस सूची को earliestStartTime के हिसाब से घटते क्रम में दिखाया जाता है. पेज का साइज़ बदलने और क्वेरी के नतीजों को फ़िल्टर करने के लिए, पेज पर नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाना
या हिस्सा लेने वाले लोगों की सूची को फ़िल्टर करना लेख पढ़ें.
यहां दिए गए कोड सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले सभी लोगों की सूची देखने का तरीका बताया गया है:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN की जगह, वह ऐक्सेस टोकन डालें जो एपीआई का ऐक्सेस देता है.
पेरंट के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस के खास आईडी का नाम डालें.
पेज पर नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाना या हिस्सा लेने वाले लोगों की सूची को फ़िल्टर करना
हिस्सा लेने वाले लोगों की सूची को फ़िल्टर करने या पेज पर नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाने के लिए, ये क्वेरी पैरामीटर पास करें:
pageSize: हिस्सा लेने वाले लोगों की वह ज़्यादा से ज़्यादा संख्या जो दिखाई जानी है. ऐसा हो सकता है कि सेवा, इस वैल्यू से कम संख्या में नतीजे दिखाए. अगर इसे तय नहीं किया जाता है, तो ज़्यादा से ज़्यादा 100 लोग दिखाए जाते हैं. इसकी ज़्यादा से ज़्यादा वैल्यू 250 है. अगर वैल्यू 250 से ज़्यादा होती है, तो उसे अपने-आप 250 में बदल दिया जाता है.pageToken: यह पेज टोकन, सूची के लिए किए गए पिछले कॉल से मिला होता है. अगला पेज पाने के लिए, यह टोकन डालें.filter: यह पैरामीटर ज़रूरी नहीं है.participantsसंसाधन के नतीजों में, खास आइटम पाने के लिए क्वेरी फ़िल्टर.earliestStartTimeयाlatestEndTimeफ़ील्ड का इस्तेमाल करके, उन उपयोगकर्ताओं को फ़िल्टर किया जा सकता है जो किसी तय समय से पहले शामिल हुए थे या तय समय के बाद मीटिंग से बाहर हुए थे. दोनों फ़ील्ड, टाइमस्टैंप फ़ॉर्मैट का इस्तेमाल करते हैं. यह फ़ॉर्मैट आरएफ़सी 3339 यूटीसी "Zulu" फ़ॉर्मैट में होता है. इसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल डिजिट तक की वैल्यू होती है:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. उदाहरण के लिए:earliestStartTime < 2023-10-01T15:01:23ZlatestEndTime < 2023-10-01T15:01:23Z
मौजूदा कॉन्फ़्रेंस में हिस्सा लेने वाले सभी लोगों की सूची देखने के लिए,
latestEndTime IS NULLका इस्तेमाल करें.
People API की मदद से, कॉन्फ़्रेंस में हिस्सा लेने वाले लोगों की जानकारी पाना
कॉन्फ़्रेंस में हिस्सा लेने वाले किसी व्यक्ति के बारे में जानकारी पाने के लिए, People API में मौजूद
people संसाधन पर
get तरीके का इस्तेमाल करें.
पाथ के आखिरी कॉम्पोनेंट का इस्तेमाल करके,
participantसंसाधन से व्यक्ति का आईडी निकालें. उदाहरण के लिए, अगरparticipantसंसाधन की वैल्यूconferenceRecords/abc-123/participants/12345है, तो People API के लिए आईडी12345होगा.READ_SOURCE_TYPE_PROFILE,READ_SOURCE_TYPE_CONTACT, औरREAD_SOURCE_TYPE_OTHER_CONTACTReadSourceTypeशामिल करें. इससे यह पक्का होता है कि Google Workspace संगठन के अंदर के उपयोगकर्ता और संगठन के बाहर के संपर्क, दोनों को जवाब में शामिल किया जाए.
यहां दिए गए कोड सैंपल में, किसी व्यक्ति की संगठन की प्रोफ़ाइल और संपर्कों, दोनों को खोजने का तरीका बताया गया है:
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed
इनकी जगह ये डालें:
- PERSON_ID: उस व्यक्ति का आईडी जिसे ढूंढना है.
- ACCESS_TOKEN: वह ऐक्सेस टोकन जो कई एपीआई का ऐक्सेस देता है.
कॉन्फ़्रेंस में हिस्सा लेने वाले लोगों के सेशन
इन सेक्शन में, कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले किसी व्यक्ति के सेशन के बारे में जानकारी पाने का तरीका बताया गया है.
कॉन्फ़्रेंस में हिस्सा लेने वाले किसी व्यक्ति के सेशन के बारे में जानकारी पाना
कॉन्फ़्रेंस में हिस्सा लेने वाले किसी व्यक्ति के सेशन के बारे में जानकारी पाने के लिए, get
तरीके का इस्तेमाल करें.
participantSessions
name पाथ पैरामीटर को conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord} फ़ॉर्मैट में सेट करें.
अगर आपको कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के सेशन का नाम नहीं पता है, तो हिस्सा लेने वाले व्यक्ति के सभी सेशन
की सूची देखने के लिए, list तरीके का इस्तेमाल किया जा सकता है.
यह तरीका, participantSessions संसाधन के इंस्टेंस के तौर पर, हिस्सा लेने वाले व्यक्ति का नाम दिखाता है.
यहां दिए गए कोड सैंपल में, कॉन्फ़्रेंस में हिस्सा लेने वाले किसी व्यक्ति के सेशन की जानकारी पाने का तरीका बताया गया है:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN की जगह, वह ऐक्सेस टोकन डालें जो एपीआई का ऐक्सेस देता है.
इनकी जगह ये डालें:
- कॉन्फ़्रेंस रिकॉर्ड के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस के खास आईडी का नाम.
- कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के खास आईडी का नाम.
- कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के सेशन के आईडी की जगह, कॉन्फ़्रेंस में हिस्सा लेने वाले व्यक्ति के खास सेशन का आईडी.
कॉन्फ़्रेंस में हिस्सा लेने वाले सभी लोगों के सेशन की सूची देखना
कॉन्फ़्रेंस
रिकॉर्ड में हिस्सा लेने वाले किसी व्यक्ति के सभी सेशन के बारे में जानकारी पाने के लिए, list()
तरीके का इस्तेमाल
participantSessions
संसाधन पर करें. parent पाथ पैरामीटर को conferenceRecords/{conferenceRecord}/participants/{participantRecord} फ़ॉर्मैट में सेट करें.
यह तरीका, participantSession संसाधन के इंस्टेंस के तौर पर, कॉन्फ़्रेंस में हिस्सा लेने वाले लोगों के सेशन की सूची दिखाता है. इस सूची को startTime के हिसाब से घटते क्रम में दिखाया जाता है. पेज का साइज़ बदलने और क्वेरी के नतीजों को फ़िल्टर करने के लिए, पेज पर नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाना या हिस्सा लेने वाले लोगों के सेशन की सूची को फ़िल्टर करना लेख पढ़ें.
यहां दिए गए कोड सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले सभी लोगों के सेशन की सूची देखने का तरीका बताया गया है:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN की जगह, वह ऐक्सेस टोकन डालें जो एपीआई का ऐक्सेस देता है.
इनकी जगह ये डालें:
- कॉन्फ़्रेंस रिकॉर्ड के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस के खास आईडी का नाम.
- पेरंट के नाम की जगह, कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले किसी व्यक्ति के सेशन का नाम.
पेज पर नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाना या हिस्सा लेने वाले लोगों के सेशन की सूची को फ़िल्टर करना
हिस्सा लेने वाले लोगों के सेशन की सूची को फ़िल्टर करने या पेज पर नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाने के लिए, ये क्वेरी पैरामीटर पास करें. ये पैरामीटर ज़रूरी नहीं हैं:
pageSize: हिस्सा लेने वाले लोगों के सेशन की वह ज़्यादा से ज़्यादा संख्या जो दिखाई जानी है. ऐसा हो सकता है कि सेवा, इस वैल्यू से कम संख्या में नतीजे दिखाए. अगर इसे तय नहीं किया जाता है, तो ज़्यादा से ज़्यादा 100 सेशन दिखाए जाते हैं. इसकी ज़्यादा से ज़्यादा वैल्यू 250 है. अगर वैल्यू 250 से ज़्यादा होती है, तो उसे अपने-आप 250 में बदल दिया जाता है.pageToken: यह पेज टोकन, सूची के लिए किए गए पिछले कॉल से मिला होता है. अगला पेज पाने के लिए, यह टोकन डालें.filter: यह पैरामीटर ज़रूरी नहीं है.participantsसंसाधन के नतीजों में, खास आइटम पाने के लिए क्वेरी फ़िल्टर.startTimeयाendTimeफ़ील्ड का इस्तेमाल करके, उन उपयोगकर्ताओं को फ़िल्टर किया जा सकता है जो किसी तय समय से पहले शामिल हुए थे या तय समय के बाद मीटिंग से बाहर हुए थे. दोनों फ़ील्ड, टाइमस्टैंप फ़ॉर्मैट का इस्तेमाल करते हैं. यह फ़ॉर्मैट आरएफ़सी 3339 यूटीसी "Zulu" फ़ॉर्मैट में होता है. इसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल डिजिट तक की वैल्यू होती है:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. उदाहरण के लिए:startTime < 2023-10-01T15:01:23ZendTime < 2023-10-01T15:01:23Z
कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले सभी लोगों के सेशन की सूची देखने के लिए,
endTime IS NULLका इस्तेमाल करें.