এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Meet REST API ব্যবহার করে অতীতের কোনও সম্মেলনে অংশগ্রহণকারী বা সক্রিয় সম্মেলনে অংশগ্রহণকারী অংশগ্রহণকারীদের সম্পর্কে বিস্তারিত তথ্য এবং তাদের সেশনের তথ্য পাবেন।
একজন অংশগ্রহণকারী হলেন এমন একজন ব্যক্তি যিনি একটি কলে যুক্ত আছেন অথবা যিনি কম্প্যানিয়ন মোড ব্যবহার করেন, দর্শক হিসেবে দেখছেন, অথবা একটি কলের সাথে সংযুক্ত একটি রুম ডিভাইস। প্রতিটি ব্যক্তির জন্য একটি participants রিসোর্স রয়েছে।
একটি অংশগ্রহণকারী সেশন হল একটি অনন্য সেশন আইডি যা প্রতিটি অংশগ্রহণকারী-ডিভাইস জোড়ার জন্য তৈরি করা হয় যারা একটি কলে যোগ দেয়। প্রতিটি সেশনের জন্য একটি participantSessions রিসোর্স থাকে। যদি অংশগ্রহণকারী একই অংশগ্রহণকারী-ডিভাইস জোড়া থেকে একই কলে একাধিকবার যোগদান করে, তাহলে তাদের প্রত্যেককে অনন্য সেশন আইডি দেওয়া হয়।
আপনি যদি একজন মিটিং স্পেসের মালিক বা অংশগ্রহণকারী হন, তাহলে অংশগ্রহণকারীদের রেকর্ড পুনরুদ্ধারের জন্য participants এবং participantSessions রিসোর্স উভয়েরই get অ্যান্ড list পদ্ধতিতে কল করতে পারেন।
ব্যবহারকারীর শংসাপত্র ব্যবহার করে প্রমাণীকরণ এবং অনুমোদনের মাধ্যমে Google Meet অ্যাপগুলি ব্যবহারকারীর ডেটা অ্যাক্সেস করতে এবং প্রমাণীকরণকৃত ব্যবহারকারীর পক্ষে ক্রিয়াকলাপ সম্পাদন করতে পারে। ডোমেন-ওয়াইড ডেলিগেশন ব্যবহার করে প্রমাণীকরণের মাধ্যমে আপনি প্রতিটি ব্যবহারকারীর সম্মতি ছাড়াই আপনার ব্যবহারকারীর ডেটা অ্যাক্সেস করার জন্য একটি অ্যাপ্লিকেশনের পরিষেবা অ্যাকাউন্টকে অনুমোদন করতে পারেন।
অংশগ্রহণকারীরা
নিম্নলিখিত বিভাগগুলিতে সম্মেলনের রেকর্ডে অংশগ্রহণকারীদের সম্পর্কে তথ্য কীভাবে পেতে হয় তা বিস্তারিতভাবে বর্ণনা করা হয়েছে।
participants user ক্ষেত্রের সাথে ইউনিয়নের রিসোর্স করে। একজন user নিম্নলিখিত বস্তুগুলির মধ্যে কেবল একটি হতে পারে:
একজন
signedinUserহল:একজন ব্যক্তি ব্যক্তিগত কম্পিউটার, মোবাইল ডিভাইস, অথবা কম্প্যানিয়ন মোডের মাধ্যমে যোগদান করছেন।
কনফারেন্স রুম ডিভাইসগুলিতে ব্যবহৃত একটি রোবট অ্যাকাউন্ট।
একজন
anonymousUserহলেন একজন অজ্ঞাত ব্যবহারকারী যিনি কোনও Google অ্যাকাউন্টে সাইন ইন করেননি।phoneUserহলো এমন একজন ব্যবহারকারী যিনি এমন একটি ফোন থেকে ডায়াল করেন যেখানে ব্যবহারকারীর পরিচয় অজানা থাকে কারণ তারা গুগল অ্যাকাউন্ট দিয়ে সাইন ইন করেননি।
মনে রাখবেন যে তিনটি অবজেক্টই একটি displayName প্রদান করে, signedinUser একটি অনন্য user আইডি প্রদান করে যা অ্যাডমিন SDK API এবং People API এর সাথে ইন্টারঅপারেবল। ফর্ম্যাট: users/{user} । People API এর সাথে user আইডি ব্যবহার সম্পর্কে আরও তথ্যের জন্য, People API এর সাথে অংশগ্রহণকারীদের বিবরণ পুনরুদ্ধার করুন দেখুন।
একজন অংশগ্রহণকারী সম্পর্কে বিস্তারিত জানুন
নির্দিষ্ট অংশগ্রহণকারী সম্পর্কে বিস্তারিত জানতে, participants রিসোর্সে get পদ্ধতি ব্যবহার করুন। conferenceRecords/{conferenceRecord}/participants/{participantRecord} ফর্ম্যাট ব্যবহার করে name path প্যারামিটার সেট করুন।
যদি আপনি অংশগ্রহণকারীর নাম না জানেন, তাহলে list পদ্ধতি ব্যবহার করে আপনি সমস্ত অংশগ্রহণকারীর নাম তালিকাভুক্ত করতে পারেন।
এই পদ্ধতিটি অংশগ্রহণকারীদের তথ্যকে participants রিসোর্সের উদাহরণ হিসেবে প্রদান করে।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একজন নির্দিষ্ট অংশগ্রহণকারীকে পুনরুদ্ধার করতে হয়:
জাভা
নোড.জেএস
পাইথন
সিআরএল
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN পরিবর্তে API-তে অ্যাক্সেস প্রদানকারী অ্যাক্সেস টোকেনটি ব্যবহার করুন।
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- একটি কনফারেন্স রেকর্ডে নির্দিষ্ট কনফারেন্স আইডির নাম সহ কনফারেন্স রেকর্ডের নাম।
- একটি সম্মেলন রেকর্ডে অংশগ্রহণকারীর নাম এবং নির্দিষ্ট অংশগ্রহণকারীর আইডির নাম।
সকল অংশগ্রহণকারীদের তালিকা তৈরি করুন
একটি কনফারেন্স রেকর্ডে সকল অংশগ্রহণকারীদের সম্পর্কে বিস্তারিত তালিকাভুক্ত করতে, participants রিসোর্সে list পদ্ধতি ব্যবহার করুন। conferenceRecords/{conferenceRecord} ফর্ম্যাট ব্যবহার করে parent পাথ প্যারামিটার সেট করুন।
এই পদ্ধতিটি অংশগ্রহণকারীদের participants উদাহরণ হিসেবে, earliestStartTime অনুসারে অবরোহী ক্রমে ক্রমানুসারে কনফারেন্স অংশগ্রহণকারীদের একটি তালিকা প্রদান করে। পৃষ্ঠার আকার সামঞ্জস্য করতে এবং ক্যোয়ারির ফলাফল ফিল্টার করতে, কাস্টমাইজ পৃষ্ঠাকরণ দেখুন অথবা অংশগ্রহণকারীদের তালিকা ফিল্টার করুন ।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি কনফারেন্স রেকর্ডে সমস্ত অংশগ্রহণকারীদের তালিকাভুক্ত করতে হয়:
জাভা
নোড.জেএস
পাইথন
সিআরএল
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN পরিবর্তে API-তে অ্যাক্সেস প্রদানকারী অ্যাক্সেস টোকেনটি ব্যবহার করুন।
একটি কনফারেন্স রেকর্ডে নির্দিষ্ট কনফারেন্স আইডির নাম দিয়ে পিতামাতার নামটি প্রতিস্থাপন করুন।
অংশগ্রহণকারীদের তালিকা কাস্টমাইজ করুন অথবা ফিল্টার করুন।
অংশগ্রহণকারীদের পৃষ্ঠাঙ্কন কাস্টমাইজ করতে বা ফিল্টার করতে নিম্নলিখিত কোয়েরি প্যারামিটারগুলি পাস করুন:
pageSize: অংশগ্রহণকারীদের সর্বাধিক সংখ্যা যতবার ফেরত পাঠানো হবে। পরিষেবাটি এই মানের চেয়ে কম ফেরত দিতে পারে। যদি নির্দিষ্ট না করা থাকে, তাহলে সর্বাধিক ১০০ জন অংশগ্রহণকারী ফেরত দেওয়া হবে। সর্বোচ্চ মান হল ২৫০; ২৫০ এর বেশি মান স্বয়ংক্রিয়ভাবে ২৫০ এ পরিবর্তিত হবে।pageToken: পূর্ববর্তী তালিকা কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন।filter: ঐচ্ছিক।participantsরিসোর্স ফলাফলে নির্দিষ্ট আইটেমগুলি পুনরুদ্ধার করার জন্য একটি কোয়েরি ফিল্টার।নির্দিষ্ট সময়ের আগে যোগদানকারী বা পরে চলে যাওয়া ব্যবহারকারীদের ফিল্টার করার জন্য আপনি
earliestStartTimeবাlatestEndTimeক্ষেত্রগুলি ব্যবহার করতে পারেন। উভয় ক্ষেত্রই RFC 3339 UTC "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 resource-এ 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 \
'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 : অ্যাক্সেস টোকেন যা একাধিক API-তে অ্যাক্সেস দেয়।
অংশগ্রহণকারীদের সেশন
নিম্নলিখিত বিভাগগুলিতে একটি সম্মেলনের রেকর্ডে অংশগ্রহণকারীর অংশগ্রহণকারী অধিবেশন সম্পর্কে তথ্য কীভাবে পেতে হয় তার বিশদ বিবরণ দেওয়া হয়েছে।
অংশগ্রহণকারী সেশন সম্পর্কে বিস্তারিত জানুন
একটি নির্দিষ্ট অংশগ্রহণকারী সেশন সম্পর্কে বিস্তারিত জানতে, participantSessions রিসোর্সে get পদ্ধতি ব্যবহার করুন। conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord} ফর্ম্যাট ব্যবহার করে name path প্যারামিটার সেট করুন।
যদি আপনি অংশগ্রহণকারীর সেশনের নাম না জানেন, তাহলে list পদ্ধতি ব্যবহার করে আপনি একজন অংশগ্রহণকারীর সমস্ত অংশগ্রহণকারী সেশন তালিকাভুক্ত করতে পারেন।
এই পদ্ধতিটি অংশগ্রহণকারীর নামকে participantSessions সেশন রিসোর্সের উদাহরণ হিসেবে প্রদান করে।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি নির্দিষ্ট অংশগ্রহণকারী সেশন পুনরুদ্ধার করতে হয়:
জাভা
নোড.জেএস
পাইথন
সিআরএল
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 পরিবর্তে API-তে অ্যাক্সেস প্রদানকারী অ্যাক্সেস টোকেনটি ব্যবহার করুন।
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- একটি কনফারেন্স রেকর্ডে নির্দিষ্ট কনফারেন্স আইডির নাম সহ কনফারেন্স রেকর্ডের নাম।
- একটি সম্মেলন রেকর্ডে অংশগ্রহণকারীর নাম এবং নির্দিষ্ট অংশগ্রহণকারীর আইডির নাম।
- অংশগ্রহণকারীর সেশন আইডি এবং নির্দিষ্ট অংশগ্রহণকারীর সেশনের আইডি।
সকল অংশগ্রহণকারী সেশনের তালিকা তৈরি করুন
কনফারেন্স রেকর্ডে অংশগ্রহণকারীর সকল অংশগ্রহণকারী সেশনের বিশদ তালিকাভুক্ত করতে, participantSessions রিসোর্সে list() পদ্ধতিটি ব্যবহার করুন। conferenceRecords/{conferenceRecord}/participants/{participantRecord} ফর্ম্যাট ব্যবহার করে parent পাথ প্যারামিটার সেট করুন।
এই পদ্ধতিটি অংশগ্রহণকারী সেশনের একটি তালিকা প্রদান করে, যা startTime অনুসারে অবরোহী ক্রমে ক্রমানুসারে সাজানো হয়, একটি participantSession সেশন রিসোর্সের উদাহরণ হিসেবে। পৃষ্ঠার আকার সামঞ্জস্য করতে এবং কোয়েরির ফলাফল ফিল্টার করতে, কাস্টমাইজ পৃষ্ঠাকরণ দেখুন অথবা অংশগ্রহণকারী সেশন তালিকা ফিল্টার করুন ।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি কনফারেন্স রেকর্ডে সমস্ত অংশগ্রহণকারী সেশন তালিকাভুক্ত করতে হয়:
জাভা
নোড.জেএস
পাইথন
সিআরএল
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN পরিবর্তে API-তে অ্যাক্সেস প্রদানকারী অ্যাক্সেস টোকেনটি ব্যবহার করুন।
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- একটি কনফারেন্স রেকর্ডে নির্দিষ্ট কনফারেন্স আইডির নাম সহ কনফারেন্স রেকর্ডের নাম।
- একটি সম্মেলনের রেকর্ডে অংশগ্রহণকারীর অংশগ্রহণকারী সেশনের নাম সহ পিতামাতার নাম।
অংশগ্রহণকারীদের সেশন তালিকার পৃষ্ঠাঙ্কন কাস্টমাইজ করুন বা ফিল্টার করুন
অংশগ্রহণকারী সেশনের পৃষ্ঠাঙ্কন কাস্টমাইজ করতে বা ফিল্টার করতে নিম্নলিখিত ঐচ্ছিক কোয়েরি প্যারামিটারগুলি পাস করুন:
pageSize: অংশগ্রহণকারীর সর্বোচ্চ কতটি সেশন ফেরত পাঠানো হবে। পরিষেবাটি এই মানের চেয়ে কম ফেরত দিতে পারে। যদি নির্দিষ্ট না করা থাকে, তাহলে সর্বাধিক ১০০টি অংশগ্রহণকারীর সেশন ফেরত দেওয়া হবে। সর্বাধিক মান হল ২৫০; ২৫০ এর বেশি মান স্বয়ংক্রিয়ভাবে ২৫০ এ পরিবর্তিত হবে।pageToken: পূর্ববর্তী তালিকা কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন।filter: ঐচ্ছিক।participantsরিসোর্স ফলাফলে নির্দিষ্ট আইটেমগুলি পুনরুদ্ধার করার জন্য একটি কোয়েরি ফিল্টার।নির্দিষ্ট সময়ের আগে যোগদানকারী বা পরে চলে যাওয়া ব্যবহারকারীদের ফিল্টার করার জন্য আপনি
startTimeঅথবাendTimeক্ষেত্র ব্যবহার করতে পারেন। উভয় ক্ষেত্রই RFC 3339 UTC "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ব্যবহার করুন।-