इस गाइड में, 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}
.
यह तरीका, कॉन्फ़्रेंस में शामिल लोगों की सूची दिखाता है. इस सूची को earliestStartTime
के हिसाब से घटते हुए क्रम में लगाया जाता है. यह सूची, participants
संसाधन के उदाहरण के तौर पर दिखती है. पेज का साइज़ बदलने और क्वेरी के नतीजों को फ़िल्टर करने के लिए, पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाएं या हिस्सा लेने वाले लोगों की सूची को फ़िल्टर करें लेख पढ़ें.
यहां दिए गए कोड के सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में शामिल सभी लोगों की सूची बनाने का तरीका बताया गया है:
Java
Node.js
Python
पैरंट वैल्यू को कॉन्फ़्रेंस रिकॉर्ड के नाम से बदलें.
पेज नंबर को पसंद के मुताबिक बनाएं या हिस्सा लेने वालों की सूची को फ़िल्टर करें
पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाने या फ़िल्टर करने के लिए, यहां दिए गए क्वेरी पैरामीटर पास करें:
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: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}
.
यह तरीका, startTime
के हिसाब से घटते क्रम में व्यवस्थित किए गए, कॉल में शामिल लोगों के सेशन की सूची दिखाता है. यह सूची, participantSession
संसाधन के इंस्टेंस के तौर पर दिखती है. पेज के साइज़ में बदलाव करने और क्वेरी के नतीजों को फ़िल्टर करने के लिए, पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाएं या हिस्सा लेने वाले लोगों के सेशन की सूची को फ़िल्टर करें लेख पढ़ें.
यहां दिए गए कोड के सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले सभी लोगों के सेशन की सूची बनाने का तरीका बताया गया है:
Java
Node.js
Python
कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले व्यक्ति के सेशन के नाम से पैरंट वैल्यू बदलें.
पेज नंबर के हिसाब से बांटने की सुविधा को पसंद के मुताबिक बनाएं या मीटिंग में हिस्सा लेने वाले लोगों के सेशन की सूची को फ़िल्टर करें
भाग लेने वाले लोगों के सेशन को पेज के हिसाब से व्यवस्थित करने या फ़िल्टर करने के लिए, यहां दिए गए वैकल्पिक क्वेरी पैरामीटर पास करें:
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:23Z
endTime < 2023-10-01T15:01:23Z
कॉन्फ़्रेंस रिकॉर्ड में, हिस्सा लेने वाले सभी लोगों के चालू सेशन की सूची बनाने के लिए,
endTime IS NULL
का इस्तेमाल करें.