يشرح هذا الدليل كيفية الحصول على تفاصيل حول المشاركين الذين حضروا مكالمة فيديو سابقة أو الذين يشاركون في مكالمة فيديو نشطة، بالإضافة إلى معلومات الجلسة، وذلك باستخدام واجهة برمجة تطبيقات 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:23Z
latestEndTime < 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_CONTACT
ReadSourceType
. يضمن ذلك تضمين كل من المستخدمين الداخليين في مؤسسة 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:23Z
endTime < 2023-10-01T15:01:23Z
لعرض جميع جلسات المشاركين النشطين في سجلّ المؤتمر، استخدِم
endTime IS NULL
.