इस गाइड में, 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
मीटिंग में हिस्सा लेने वाले व्यक्ति के नाम की जगह, मीटिंग के रिकॉर्ड में मौजूद किसी व्यक्ति का आईडी डालें.
मीटिंग में हिस्सा लेने वाले सभी लोगों की सूची बनाना
कॉन्फ़्रेंस रिकॉर्ड में शामिल सभी लोगों की जानकारी पाने के लिए, participants रिसॉर्स पर list() तरीके का इस्तेमाल करें. इसके लिए, parent पाथ पैरामीटर का इस्तेमाल करें. फ़ॉर्मैट:
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: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: यह ऐक्सेस टोकन है, जो कई एपीआई को ऐक्सेस करने की अनुमति देता है.
मीटिंग में हिस्सा लेने वाले लोगों के सेशन
यहां दिए गए सेक्शन में, कॉन्फ़्रेंस रिकॉर्ड में हिस्सा लेने वाले किसी व्यक्ति के सेशन के बारे में जानकारी पाने का तरीका बताया गया है.
मीटिंग में हिस्सा लेने वाले किसी व्यक्ति के सेशन के बारे में जानकारी पाना
किसी खास सेशन में हिस्सा लेने वाले व्यक्ति की जानकारी पाने के लिए, 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 यूटीसी "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का इस्तेमाल करें.