इस गाइड में, Google Meet REST API का इस्तेमाल करके, उन लोगों के बारे में जानकारी पाने का तरीका बताया गया है जो किसी पिछली कॉन्फ़्रेंस में शामिल थे या जो किसी चालू कॉन्फ़्रेंस में शामिल हैं. साथ ही, उनके सेशन की जानकारी भी पाने का तरीका बताया गया है.
मीटिंग में हिस्सा लेने वाला व्यक्ति वह होता है जो कॉल में शामिल होता है या कंपैनियन मोड का इस्तेमाल करके, दर्शक के तौर पर कॉल देखता है. इसके अलावा, कॉल में शामिल रूम डिवाइस भी मीटिंग में हिस्सा लेने वाला व्यक्ति माना जाता है. हर व्यक्ति के लिए एक
participants
रिसॉर्स होता है.
उपयोगकर्ता का सेशन, कॉल में शामिल होने वाले हर उपयोगकर्ता-डिवाइस जोड़े के लिए बनाया गया यूनीक सेशन आईडी होता है.
हर सेशन के लिए एक
participantSessions
रिसॉर्स होता है. अगर कोई व्यक्ति एक ही कॉल में, एक ही व्यक्ति-डिवाइस जोड़े से कई बार शामिल होता है, तो उसे हर बार एक यूनीक सेशन आईडी असाइन किया जाता है.
अगर आप मीटिंग स्पेस के मालिक या उसमें हिस्सा लेने वाले व्यक्ति हैं, तो मीटिंग में हिस्सा लेने वाले लोगों के रिकॉर्ड वापस पाने के लिए, participants
और participantSessions
दोनों संसाधनों पर get()
और list()
तरीकों का इस्तेमाल किया जा सकता है.
उपयोगकर्ता के क्रेडेंशियल की मदद से पुष्टि करने और अनुमति देने पर, Google Meet ऐप्लिकेशन, उपयोगकर्ता का डेटा ऐक्सेस कर सकते हैं. साथ ही, पुष्टि किए गए उपयोगकर्ता की ओर से कार्रवाइयां कर सकते हैं. डोमेन के लिए ऐक्सेस देने की सुविधा का इस्तेमाल करके पुष्टि करने पर, आपको ऐप्लिकेशन के सेवा खाते को अपने उपयोगकर्ताओं का डेटा ऐक्सेस करने की अनुमति देने की सुविधा मिलती है. इसके लिए, आपको हर उपयोगकर्ता से सहमति लेने की ज़रूरत नहीं होती.
पार्टी में शामिल लोग
यहां दिए गए सेक्शन में, कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले लोगों के बारे में जानकारी पाने का तरीका बताया गया है.
participants
संसाधन, user
फ़ील्ड के साथ यूनियन करता है. user
, इनमें से सिर्फ़ एक ऑब्जेक्ट हो सकता है:
signedinUser
इनमें से कोई एक है:कोई व्यक्ति, निजी कंप्यूटर, मोबाइल डिवाइस या कंपैनियन मोड से मीटिंग में शामिल हो रहा है.
कॉन्फ़्रेंस रूम के डिवाइसों के लिए इस्तेमाल किया जाने वाला रोबोट खाता.
anonymousUser
एक ऐसा उपयोगकर्ता है जिसकी पहचान नहीं की जा सकी है और जिसने Google खाते में साइन इन नहीं किया है.phoneUser
का मतलब है कि उपयोगकर्ता ने किसी ऐसे फ़ोन से डायल इन किया है जिस पर उसकी पहचान की पुष्टि नहीं की गई है. ऐसा इसलिए, क्योंकि उसने Google खाते से साइन इन नहीं किया है.
ध्यान दें कि तीनों ऑब्जेक्ट displayName
दिखाते हैं. हालांकि, signedinUser
एक यूनीक user
आईडी भी दिखाता है. यह आईडी, Admin SDK API और People API के साथ काम करता है. फ़ॉर्मैट: users/{user}
. People API के साथ user
आईडी का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, People API की मदद से, सेशन में हिस्सा लेने वाले व्यक्ति की जानकारी पाना लेख पढ़ें.
मीटिंग में हिस्सा लेने वाले किसी व्यक्ति के बारे में जानकारी पाना
किसी खास व्यक्ति के बारे में जानकारी पाने के लिए, name
पाथ पैरामीटर के साथ participants
संसाधन पर, get()
तरीके का इस्तेमाल करें. अगर आपको मीटिंग में हिस्सा लेने वाले व्यक्ति का नाम नहीं पता है, तो list()
तरीका इस्तेमाल करके, मीटिंग में हिस्सा लेने वाले सभी लोगों के नामों की सूची देखी जा सकती है.
यह तरीका, participants
रिसोर्स के इंस्टेंस के तौर पर, किसी व्यक्ति का डेटा दिखाता है.
नीचे दिए गए कोड सैंपल में, किसी खास व्यक्ति की जानकारी पाने का तरीका बताया गया है:
Java
Node.js
Python
मीटिंग के रिकॉर्ड में, मीटिंग में हिस्सा लेने वाले व्यक्ति के नाम की जगह, उस व्यक्ति के आईडी का नाम डालें.
मीटिंग में हिस्सा लेने वाले सभी लोगों की सूची देखना
किसी कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले सभी लोगों की जानकारी देखने के लिए, parent
पाथ पैरामीटर के साथ participants
संसाधन पर list()
तरीके का इस्तेमाल करें. फ़ॉर्मैट:
conferenceRecords/{conferenceRecord}
.
यह तरीका, participants
संसाधन के उदाहरण के तौर पर, earliestStartTime
के घटते क्रम में कॉन्फ़्रेंस में हिस्सा लेने वाले लोगों की सूची दिखाता है. पेज का साइज़ अडजस्ट करने और क्वेरी के नतीजों को फ़िल्टर करने के लिए, पेजेशन को पसंद के मुताबिक बनाने या हिस्सा लेने वाले लोगों की सूची को फ़िल्टर करने का तरीका लेख पढ़ें.
यहां दिए गए कोड सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में सभी लोगों की सूची बनाने का तरीका बताया गया है:
Java
Node.js
Python
पैरंट वैल्यू को कॉन्फ़्रेंस रिकॉर्ड के नाम से बदलें.
पेजेशन को पसंद के मुताबिक बनाना या हिस्सा लेने वाले लोगों की सूची को फ़िल्टर करना
पैजेशन को पसंद के मुताबिक बनाने या हिस्सा लेने वाले लोगों को फ़िल्टर करने के लिए, ये क्वेरी पैरामीटर पास करें:
pageSize
: हिस्सा लेने वाले लोगों की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सेवा, इस वैल्यू से कम डेटा दिखाए. अगर कोई वैल्यू नहीं दी जाती है, तो ज़्यादा से ज़्यादा 100 लोगों की जानकारी दिखती है. ज़्यादा से ज़्यादा वैल्यू 250 हो सकती है. 250 से ज़्यादा वैल्यू होने पर, वे अपने-आप 250 हो जाती हैं.pageToken
: सूची के पिछले कॉल से मिला पेज टोकन. अगला पेज देखने के लिए, यह टोकन दें.filter
: ज़रूरी नहीं.participants
संसाधन के नतीजों में खास आइटम पाने के लिए क्वेरी फ़िल्टर.earliestStartTime
याlatestEndTime
फ़ील्ड का इस्तेमाल करके, उन उपयोगकर्ताओं को फ़िल्टर किया जा सकता है जो किसी तय समय से पहले शामिल हुए थे या तय समय के बाद चले गए थे. दोनों फ़ील्ड, आरएफ़सी 3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में, टाइमस्टैंप फ़ॉर्मैट का इस्तेमाल करते हैं. इसमें नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंक होते हैं:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. उदाहरण के लिए:earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 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_CONTACT
ReadSourceType
को शामिल करें. इससे यह पक्का होता है कि जवाब में, 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: ऐक्सेस टोकन, जो कई एपीआई का ऐक्सेस देता है.
मीटिंग में हिस्सा लेने वाले लोगों के सेशन
नीचे दिए गए सेक्शन में, कॉन्फ़्रेंस रिकॉर्ड में किसी व्यक्ति के सेशन के बारे में जानकारी पाने का तरीका बताया गया है.
मीटिंग में हिस्सा लेने वाले किसी व्यक्ति के सेशन के बारे में जानकारी पाना
किसी खास व्यक्ति के सेशन की जानकारी पाने के लिए, name
पाथ पैरामीटर के साथ participantSessions
संसाधन पर get()
तरीके का इस्तेमाल करें. अगर आपको मीटिंग में हिस्सा लेने वाले व्यक्ति के सेशन का नाम नहीं पता है, तो list()
तरीके का इस्तेमाल करके, मीटिंग में हिस्सा लेने वाले व्यक्ति के सभी सेशन की सूची देखी जा सकती है.
यह तरीका, participantSessions
रिसोर्स के इंस्टेंस के तौर पर, मीटिंग में हिस्सा लेने वाले व्यक्ति का नाम दिखाता है.
यहां दिए गए कोड सैंपल में, किसी खास व्यक्ति के सेशन को वापस पाने का तरीका बताया गया है:
Java
Node.js
Python
मीटिंग में हिस्सा लेने वाले व्यक्ति के नाम को, मीटिंग में हिस्सा लेने वाले व्यक्ति के सेशन के आईडी से बदलें.
मीटिंग में हिस्सा लेने वाले सभी लोगों के सेशन की सूची बनाना
कॉन्फ़्रेंस रिकॉर्ड में, किसी व्यक्ति के सभी सेशन की जानकारी देखने के लिए, parent
पाथ पैरामीटर के साथ participantSessions
संसाधन पर list()
तरीके का इस्तेमाल करें. फ़ॉर्मैट:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
यह तरीका, participantSession
रिसॉर्स के इंस्टेंस के तौर पर, startTime
के घटते क्रम में, मीटिंग में हिस्सा लेने वाले लोगों के सेशन की सूची दिखाता है. पेज का साइज़ बदलने और क्वेरी के नतीजों को फ़िल्टर करने के लिए, पेजेशन को पसंद के मुताबिक बनाने या हिस्सा लेने वाले लोगों के सेशन की सूची को फ़िल्टर करने का तरीका देखें.
नीचे दिए गए कोड सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में, मीटिंग में हिस्सा लेने वाले सभी लोगों के सेशन की सूची बनाने का तरीका बताया गया है:
Java
Node.js
Python
पैरंट वैल्यू को, कॉन्फ़्रेंस रिकॉर्ड में किसी व्यक्ति के सेशन के नाम से बदलें.
पेजेशन को पसंद के मुताबिक बनाना या मीटिंग में हिस्सा लेने वाले लोगों के सेशन की सूची को फ़िल्टर करना
पैजेशन को पसंद के मुताबिक बनाने या हिस्सा लेने वाले लोगों के सेशन को फ़िल्टर करने के लिए, यहां दिए गए वैकल्पिक क्वेरी पैरामीटर पास करें:
pageSize
: इसमें, मीटिंग में हिस्सा लेने वाले लोगों के सेशन की ज़्यादा से ज़्यादा संख्या दिखती है. ऐसा हो सकता है कि सेवा इस वैल्यू से कम आइटम दिखाए. अगर कोई संख्या नहीं दी जाती है, तो ज़्यादा से ज़्यादा 100 उपयोगकर्ताओं के सेशन दिखाए जाते हैं. ज़्यादा से ज़्यादा वैल्यू 250 हो सकती है. 250 से ज़्यादा वैल्यू होने पर, वे अपने-आप 250 हो जाती हैं.pageToken
: सूची के पिछले कॉल से मिला पेज टोकन. अगला पेज देखने के लिए, यह टोकन दें.filter
: ज़रूरी नहीं.participants
संसाधन के नतीजों में खास आइटम पाने के लिए क्वेरी फ़िल्टर.startTime
याendTime
फ़ील्ड का इस्तेमाल करके, उन उपयोगकर्ताओं को फ़िल्टर किया जा सकता है जो किसी तय समय से पहले शामिल हुए थे या तय समय के बाद चले गए थे. दोनों फ़ील्ड, आरएफ़सी 3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में, टाइमस्टैंप फ़ॉर्मैट का इस्तेमाल करते हैं. इसमें नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंक होते हैं:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. उदाहरण के लिए:startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
कॉन्फ़्रेंस रिकॉर्ड में, कॉन्फ़्रेंस में हिस्सा लेने वाले सभी लोगों के चालू सेशन की सूची देखने के लिए,
endTime IS NULL
का इस्तेमाल करें.