يوضّح هذا الدليل كيفية الحصول على تفاصيل عن المشاركين الذين حضروا مؤتمرًا سابقًا أو الذين يشاركون في مؤتمر نشط، بالإضافة إلى معلومات الجلسة الخاصة بهم، باستخدام Google Meet REST API.
المشارك هو شخص انضم إلى مكالمة أو يستخدم وضع المزاملة أو يشاهد كمشاهد أو جهاز غرفة متصل بمكالمة. هناك مورد
participants
واحد لكل شخص.
جلسة المشارك
هي معرّف جلسة فريد يتم إنشاؤه لكل زوج من المشاركين والأجهزة التي تنضم إلى
مكالمة. هناك مورد واحد
participantSessions
لكل جلسة. إذا انضم المشارك إلى المكالمة نفسها عدة مرات من خلال الزوج نفسه من المشاركين والأجهزة، يتم تخصيص معرّفات جلسات فريدة لكل مرة.
إذا كنت مالك مساحة اجتماع أو مشاركًا فيها، يمكنك استدعاء الطريقتَين get وlist على كل من الموردَين participants وparticipantSessions لاسترداد سجلّات المشاركين.
يسمح لك المصادقة والتفويض باستخدام بيانات اعتماد المستخدم لتطبيقات Google Meet بالوصول إلى بيانات المستخدم وإجراء عمليات نيابةً عن المستخدم الذي تم التحقّق من هويته. تسمح لك المصادقة باستخدام التفويض على مستوى النطاق بتفويض حساب خدمة تطبيق للوصول إلى بيانات المستخدمين بدون طلب موافقة كل مستخدم.
مشارك
توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات عن المشاركين في سجلّ مؤتمر.
يتّحد المورد
participants
مع الحقل user. يمكن أن يكون user أحد الكائنات التالية فقط:
A
signedinUserهو أحد الخيارَين التاليَين:مستخدم ينضم من جهاز كمبيوتر شخصي أو جهاز جوّال أو من خلال وضع المزاملة
حساب روبوت تستخدمه أجهزة غرف المؤتمرات
anonymousUserهو مستخدم غير محدّد الهوية لم يسجّل الدخول إلى حساب Google.A
phoneUserهو مستخدم يتصل من هاتف لا يُعرف فيه هوية المستخدم لأنّه لم يسجّل الدخول باستخدام حساب Google.
يُرجى العِلم أنّه على الرغم من أنّ جميع الكائنات الثلاثة تعرض displayName، يعرض signedinUser أيضًا user معرّفًا فريدًا يمكن استخدامه مع Admin SDK API وPeople API. التنسيق: users/{user}. لمزيد من المعلومات عن استخدام user
المعرّف مع People API، يُرجى الاطّلاع على استرداد تفاصيل المشاركين باستخدام
People API.
الحصول على تفاصيل عن مشارك
للحصول على تفاصيل عن مشارك معيّن، استخدِم الـ
get
على الـ
participants. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
إذا كنت لا تعرف اسم المشارك، يمكنك عرض جميع أسماء المشاركين باستخدام الطريقة list.
تعرض الطريقة بيانات المشارك كمثيل لمورد participants.
تعرض عيّنة التعليمات البرمجية التالية كيفية استرداد مشارك معيّن:
جافا
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 برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.
غيِّر القيم في السلسلة على الشكل التالي:
- اسم سجلّ المؤتمر باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر
- اسم المشارك باسم معرّف المشارك المحدّد في سجلّ المؤتمر
عرض جميع المشاركين
لعرض تفاصيل عن جميع المشاركين في سجلّ مؤتمر، استخدِم الـ
list
على الـ
participants. اضبط مَعلمة المسار parent باستخدام التنسيق conferenceRecords/{conferenceRecord}.
تعرض الطريقة قائمة بالمشاركين في المؤتمر، مرتّبة حسب earliestStartTime بترتيب تنازلي، كمثيل لمورد participants. لضبط حجم الصفحة وفلترة نتائج طلب البحث، يُرجى الاطّلاع على تخصيص
ترقيم الصفحات أو فلترة قائمة المشاركين.
تعرض عيّنة التعليمات البرمجية التالية كيفية عرض جميع المشاركين في سجلّ مؤتمر:
جافا
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: رمز صفحة تم استلامه من طلب `list` سابق. قدِّم هذا الرمز لاسترداد الصفحة التالية.filter: اختياري فلتر طلب بحث لاسترداد عناصر معيّنة في نتائج الموردparticipantsيمكنك استخدام الحقلَين
earliestStartTimeأوlatestEndTimeلفلترة المستخدمين الذين انضموا قبل وقت معيّن أو غادروا بعده. يستخدم كلا الحقلَين تنسيق الطابع الزمني بتنسيق RFC 3339 UTC "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
لاسترداد تفاصيل عن مشارك، استخدِم الـ
get method على الـ
people resource في People API.
استخرِج معرّف الشخص من المورد
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: رمز الدخول الذي يمنح إذن الوصول إلى واجهات برمجة تطبيقات متعددة
جلسات المشاركين
توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات عن جلسات المشاركين في سجلّ مؤتمر.
الحصول على تفاصيل عن جلسة مشارك
للحصول على تفاصيل عن جلسة مشارك معيّنة، استخدِم الـ
get
على الـ
participantSessions. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.
إذا كنت لا تعرف اسم جلسة المشارك، يمكنك عرض جميع جلسات المشارك باستخدام الطريقة list.
تعرض الطريقة اسم المشارك كمثيل لمورد participantSessions.
تعرض عيّنة التعليمات البرمجية التالية كيفية استرداد جلسة مشارك معيّنة:
جافا
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 برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.
غيِّر القيم في السلسلة على الشكل التالي:
- اسم سجلّ المؤتمر باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر
- اسم المشارك باسم معرّف المشارك المحدّد في سجلّ المؤتمر
- معرّف جلسة المشارك بمعرّف جلسة المشارك المحدّدة
عرض جميع جلسات المشاركين
لعرض تفاصيل عن جميع جلسات المشاركين في سجلّ مؤتمر
، استخدِم
list()
الطريقة على
participantSessions
المورد. اضبط مَعلمة المسار parent باستخدام التنسيق conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
تعرض الطريقة قائمة بجلسات المشاركين، مرتّبة حسب startTime بترتيب تنازلي، كمثيل لمورد participantSession. لضبط
حجم الصفحة وفلترة نتائج طلب البحث، يُرجى الاطّلاع على تخصيص ترقيم الصفحات أو فلترة
قائمة جلسات المشاركين.
تعرض عيّنة التعليمات البرمجية التالية كيفية عرض جميع جلسات المشاركين في سجلّ مؤتمر:
جافا
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: رمز صفحة تم استلامه من طلب `list` سابق. قدِّم هذا الرمز لاسترداد الصفحة التالية.filter: اختياري فلتر طلب بحث لاسترداد عناصر معيّنة في نتائج الموردparticipantsيمكنك استخدام الحقلَين
startTimeأوendTimeلفلترة المستخدمين الذين انضموا قبل وقت معيّن أو غادروا بعده. يستخدم كلا الحقلَين تنسيق الطابع الزمني بتنسيق RFC 3339 UTC "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.