इस गाइड में बताया गया है कि 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 की मदद से, मीटिंग में हिस्सा लेने वाले लोगों की जानकारी पाना लेख पढ़ें.
मीटिंग में हिस्सा लेने वाले किसी व्यक्ति के बारे में जानकारी पाना
किसी खास प्रतिभागी के बारे में जानकारी पाने के लिए, participants रिसॉर्स पर get तरीके का इस्तेमाल करें. name फ़ॉर्मैट का इस्तेमाल करके, 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 को उस ऐक्सेस टोकन से बदलें जो एपीआई का ऐक्सेस देता है.
इनकी जगह ये डालें:
- कॉन्फ़्रेंस रिकॉर्ड का नाम, जिसमें कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस आईडी का नाम शामिल होता है.
- कॉन्फ़्रेंस के रिकॉर्ड में, मीटिंग में हिस्सा लेने वाले व्यक्ति का नाम और उसका आईडी.
मीटिंग में हिस्सा लेने वाले सभी लोगों की सूची बनाना
कॉन्फ़्रेंस रिकॉर्ड में शामिल सभी लोगों की जानकारी पाने के लिए, participants संसाधन पर list तरीके का इस्तेमाल करें. parent फ़ॉर्मैट का इस्तेमाल करके, parent पाथ पैरामीटर सेट करें.conferenceRecords/{conferenceRecord}
यह तरीका, कॉन्फ़्रेंस में शामिल लोगों की सूची दिखाता है. इस सूची में, लोगों को earliestStartTime के हिसाब से घटते हुए क्रम में दिखाया जाता है. यह सूची, participants संसाधन के उदाहरण के तौर पर दिखती है. पेज का साइज़ बदलने और क्वेरी के नतीजों को फ़िल्टर करने के लिए, पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा को पसंद के मुताबिक बनाएं या हिस्सा लेने वाले लोगों की सूची को फ़िल्टर करें लेख पढ़ें.
यहां दिए गए कोड सैंपल में, कॉन्फ़्रेंस रिकॉर्ड में शामिल सभी लोगों की सूची बनाने का तरीका बताया गया है:
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: यह ऐक्सेस टोकन है, जो कई एपीआई को ऐक्सेस करने की अनुमति देता है.
मीटिंग में हिस्सा लेने वाले लोगों के सेशन
यहां दिए गए सेक्शन में, कॉन्फ़्रेंस के रिकॉर्ड में मौजूद किसी व्यक्ति के सेशन के बारे में जानकारी पाने का तरीका बताया गया है.
किसी सेशन में हिस्सा लेने वाले व्यक्ति के बारे में जानकारी पाना
किसी खास सेशन में हिस्सा लेने वाले व्यक्ति के बारे में जानकारी पाने के लिए, participantSessions रिसॉर्स पर get तरीके का इस्तेमाल करें. name फ़ॉर्मैट का इस्तेमाल करके, 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 को उस ऐक्सेस टोकन से बदलें जो एपीआई का ऐक्सेस देता है.
इनकी जगह ये डालें:
- कॉन्फ़्रेंस रिकॉर्ड का नाम, जिसमें कॉन्फ़्रेंस रिकॉर्ड में मौजूद कॉन्फ़्रेंस आईडी का नाम शामिल होता है.
- कॉन्फ़्रेंस के रिकॉर्ड में, मीटिंग में हिस्सा लेने वाले व्यक्ति का नाम और उसका आईडी.
- इसमें हिस्सा लेने वाले व्यक्ति के सेशन का आईडी और उस सेशन का आईडी होता है.
मीटिंग में हिस्सा लेने वाले सभी लोगों के सेशन की सूची बनाना
कॉन्फ़्रेंस रिकॉर्ड में, हिस्सा लेने वाले किसी व्यक्ति के सभी सेशन की जानकारी पाने के लिए, participantSessions संसाधन पर list() तरीके का इस्तेमाल करें. parent फ़ॉर्मैट का इस्तेमाल करके, 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का इस्तेमाल करें.