يشرح هذا الدليل كيفية الحصول على تفاصيل حول المشاركين الذين حضروا مكالمة فيديو سابقة أو الذين يشاركون في مكالمة فيديو نشطة، بالإضافة إلى معلومات الجلسة، وذلك باستخدام واجهة برمجة تطبيقات 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. إذا كنت لا تعرف اسم المشارِك، يمكنك إدراج جميع أسماء المشاركين باستخدام طريقة list().
تعرض الطريقة بيانات المشارك كنموذج من participants
المورد.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد لاعب معيّن:
Java
Node.js
Python
استبدِل اسم المشارك باسم معرّف المشارك المحدّد في سجلّ مؤتمر.
عرض قائمة بجميع المشاركين
لعرض تفاصيل حول جميع المشاركين في سجلّ مؤتمر، استخدِم طريقة
list()
في المورد
participants
مع مَعلمة المسار parent. التنسيق:
conferenceRecords/{conferenceRecord}
تعرض الطريقة قائمة بالمشاركين في الاجتماع، مرتّبة حسب
earliestStartTime بترتيب تنازلي، كنموذج من مورد participants. لضبط حجم الصفحة وفلترة نتائج الطلب، اطّلِع على تخصيص تقسيم المحتوى إلى صفحات أو فلترة قائمة المشاركين.
يوضّح نموذج الرمز البرمجي التالي كيفية إدراج جميع المشاركين في سجلّ اجتماع:
Java
Node.js
Python
استبدِل قيمة العنصر الرئيسي باسم سجلّ الاجتماع.
تخصيص تقسيم الصفحات أو فلترة قائمة المشاركين
مرِّر مَعلمات طلب البحث التالية لتخصيص تقسيم المشاركين إلى صفحات أو فلترتهم:
pageSize: الحد الأقصى لعدد المشاركين المطلوب عرضه. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، سيتم عرض 100 مشارك كحدّ أقصى. الحدّ الأقصى للقيمة هو 250، ويتم تلقائيًا تغيير القيم الأكبر من 250 إلى 250.pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم الرمز المميز هذا لاسترداد الصفحة التالية.
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() في مورد
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. إذا كنت لا تعرف اسم جلسة المشارك، يمكنك إدراج جميع جلسات المشارك باستخدام طريقة list().
تعرض الطريقة اسم مشارك كمثيل لمورد participantSessions.
تعرض عيّنة الرمز البرمجي التالية كيفية استرداد جلسة مشارك معيّنة:
Java
Node.js
Python
استبدِل اسم المشارك بمعرّف جلسة المشارك المحدّد في جلسة أحد المشاركين.
عرض جميع جلسات المشاركين
لعرض تفاصيل حول جميع جلسات أحد المشاركين في سجلّ مؤتمر، استخدِم طريقة list() في مورد participantSessions مع مَعلمة المسار parent. التنسيق:
conferenceRecords/{conferenceRecord}/participants/{participant}
تعرض الطريقة قائمة بجلسات المشاركين، مرتّبة حسب startTime بترتيب تنازلي، كنموذج لمورد participantSession. لتعديل حجم الصفحة وفلترة نتائج طلب البحث، اطّلِع على تخصيص تقسيم الصفحات أو فلترة قائمة جلسات المشاركين.
تعرض عيّنة الرمز البرمجي التالية كيفية إدراج جميع جلسات المشاركين في سجلّ مؤتمر:
Java
Node.js
Python
استبدِل قيمة العنصر الأصل باسم جلسات المشاركين في سجلّ مؤتمر.
تخصيص تقسيم الصفحات أو فلترة قائمة جلسات المشاركين
مرِّر مَعلمات طلب البحث الاختيارية التالية لتخصيص تقسيم الصفحات أو فلترة جلسات المشاركين:
pageSize: الحد الأقصى لعدد جلسات المشاركين المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 100 جلسة مشارك كحد أقصى. الحد الأقصى للقيمة هو 250، ويتم تلقائيًا تغيير القيم الأكبر من 250 إلى 250.pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم الرمز المميز هذا لاسترداد الصفحة التالية.
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.