يشرح هذا الدليل كيفية الحصول على تفاصيل حول المشاركين الذين حضروا مكالمة فيديو سابقة أو الذين يشاركون في مكالمة فيديو نشطة، بالإضافة إلى معلومات الجلسة، وذلك باستخدام واجهة برمجة تطبيقات Google Meet REST.
المشارك هو شخص انضم إلى مكالمة أو يستخدم وضع المزاملة أو يشاهد كضيف أو جهاز غرفة متصل بمكالمة. يتوفّر مصدر
participants
واحد لكل شخص.
جلسة المشارِك هي رقم تعريف جلسة فريد يتم إنشاؤه لكل زوج من المشارِك والجهاز ينضم إلى مكالمة. يتوفّر
participantSessions
مورد واحد لكل جلسة. إذا انضم المشارك إلى المكالمة نفسها عدة مرات من خلال الجهاز نفسه، سيتم تخصيص أرقام تعريف جلسات فريدة لكل مرة.
إذا كنت مالكًا لمساحة اجتماع أو مشاركًا فيها، يمكنك استدعاء الطريقتَين get وlist في كل من الموردَين participants وparticipantSessions لاسترداد سجلات المشاركين.
تتيح المصادقة ومنح الإذن باستخدام بيانات اعتماد المستخدم لتطبيقات Google Meet الوصول إلى بيانات المستخدم وتنفيذ عمليات نيابةً عن المستخدم الذي تمّت المصادقة عليه. يتيح لك المصادقة باستخدام التفويض على مستوى النطاق تفويض حساب خدمة أحد التطبيقات للوصول إلى بيانات المستخدمين بدون طلب موافقة كل مستخدم.
مشارك
توضّح الأقسام التالية كيفية الحصول على معلومات حول المشاركين في سجلّ مؤتمر.
تتضمّن
participants
اتحادات الموارد الحقل user. يمكن أن يكون user أحد الكائنات التالية فقط:
signedinUserهو أحد ما يلي:مستخدم ينضم إلى الاجتماع من جهاز كمبيوتر شخصي أو جهاز جوّال أو من خلال "وضع المرافق"
حساب روبوت تستخدمه أجهزة غرف الاجتماعات
المستخدم
anonymousUserهو مستخدم مجهول الهوية لم يسجّل الدخول إلى حساب Google.phoneUserهو مستخدم يتصل من هاتف لا يمكن تحديد هويته لأنّه لم يسجّل الدخول باستخدام حساب Google.
يُرجى العِلم أنّه على الرغم من أنّ جميع العناصر الثلاثة تعرض displayName، إلا أنّ signedinUser تعرض أيضًا معرّف user فريدًا يمكن تشغيله بشكل متوافق مع واجهة برمجة تطبيقات Admin SDK و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: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم هذا الرمز المميز لاسترداد الصفحة التالية.
filter: اختياري. فلتر طلب بحث لاسترداد عناصر معيّنة في نتائج الموردparticipants.يمكنك استخدام الحقلَين
earliestStartTimeأوlatestEndTimeلفلترة المستخدمين الذين انضموا قبل وقت معيّن أو غادروا بعده. يستخدم كلا الحقلين تنسيق الطابع الزمني في RFC 3339 بالتوقيت العالمي المنسَّق مع حرف Z في النهاية، بدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام جزئية:{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 في المورد
people في 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: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم هذا الرمز المميز لاسترداد الصفحة التالية.
filter: اختياري. فلتر طلب بحث لاسترداد عناصر معيّنة في نتائج الموردparticipants.يمكنك استخدام الحقلَين
startTimeأوendTimeلفلترة المستخدمين الذين انضموا قبل وقت معيّن أو غادروا بعد وقت معيّن. يستخدم كلا الحقلين تنسيق الطابع الزمني في RFC 3339 بالتوقيت العالمي المنسَّق مع حرف Z في النهاية، بدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام جزئية:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. على سبيل المثال:startTime < 2023-10-01T15:01:23ZendTime < 2023-10-01T15:01:23Z
لعرض جميع جلسات المشاركين النشطة في سجلّ المؤتمر، استخدِم
endTime IS NULL.