المشارك هو شخص انضم إلى
مكالمة أو تستخدم وضع المزاملة
أو مشاهدة المحتوى كمشاهد
جهاز غرفة متصل بمكالمة. فِيهْ خِيَارْ
conferenceRecords.participants
مورد لكل شخص.
جلسة المشاركة هي
معرّف جلسة فريد يتم إنشاؤه لكل زوج من الأجهزة المشاركين ينضمّ إلى مكالمة.
فِيهْ خِيَارْ
conferenceRecords.participants.participantSessions
لكل جلسة. في حال انضمام المُشارِك إلى المكالمة نفسها عدة مرات
من نفس زوج الجهاز المشارك، يتم تعيين معرفات جلسة فريدة لكل منهما.
توضّح هذه الصفحة طريقة الحصول على معلومات عن جميع المشاركين الذين حضروا أو في مؤتمر أو في مشارك واحد، إلى جانب معلومات الجلسة.
مشارك
توضح الأقسام التالية بالتفصيل كيفية الحصول على معلومات حول المشاركين.
تشير رسالة الأشكال البيانية
conferenceRecords.participants
المورد تتضمن الحقل user
. يمكن أن تكون قيمة user
واحدًا فقط مما يلي:
الكائنات:
signedinUser
تكون إما:يشير هذا المصطلح إلى مستخدم ينضم من جهاز كمبيوتر شخصي أو جهاز جوّال أو من خلال "وضع المزاملة".
حساب روبوت تستخدمه أجهزة غرف المؤتمرات.
إنّ
anonymousUser
مستخدم مجهول الهوية لم يسجّل الدخول إلى أحد حسابات Google.phoneUser
هو اتصال مستخدم من هاتف تكون فيه هوية المستخدم غير معروفة لأنه لم يسجّل الدخول باستخدام حساب Google.
البحث عن جميع المشاركين
للحصول على تفاصيل حول جميع المشاركين في سجلّ مكالمة فيديو، استخدِم
list()
على
conferenceRecords.participants
مورد يتضمّن معلَمة المسار parent
.
يمكنك استخدام الحقلَين earliestStartTime
أو latestEndTime
للفلترة حسب.
المستخدمين الذين انضموا قبل أو غادروا بعد وقت معين. يستخدم كلا الحقلين دالة
الطابع الزمني
بتنسيق RFC 3339
التوقيت العالمي المتفق عليه "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية:
{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
.
تُرجع الطريقة قائمة بالمشاركين في المؤتمر، مُرتبة حسب وقت الانضمام في
تنازليًا، كمثيل لمورد conferenceRecords.participants
.
يعرض نموذج الرمز البرمجي التالي طريقة إدراج جميع المشاركين في مؤتمر التسجيل:
Java
Node.js
Python
استبدِل القيمة الرئيسية باسم سجلّ مكالمة الفيديو.
البحث عن مشارك محدد
للبحث عن مشارك معين، استخدم
get()
على
conferenceRecords.participants
مورد يتضمّن معلَمة المسار name
. لاسترداد اسم
مشارك، استخدم الطريقة conferenceRecords.participants.list
.
تُرجع الطريقة اسم مشارك كمثيل لـ
مرجع واحد (conferenceRecords.participants
)
يوضح نموذج الرمز البرمجي التالي كيفية استرداد مشارك محدد:
Java
Node.js
Python
استبدل اسم المشارك باسم المشارك المحدد للبحث عنه.
جلسات المشاركين
توضح الأقسام التالية بالتفصيل كيفية الحصول على معلومات حول جلسات المشاركين.
البحث عن جميع جلسات المشاركين
للحصول على تفاصيل حول جميع جلسات المشاركين لأحد المشاركين في مؤتمر
التسجيل، فاستخدم
list()
على
conferenceRecords.participants.participantSessions
مورد يتضمّن معلَمة المسار parent
.
يمكنك استخدام الحقلين startTime
أو endTime
لفلترة المستخدمين الذين انضموا.
قبل أو غادرت بعد وقت معين. يستخدم كلا الحقلين دالة
الطابع الزمني
التنسيق في RFC
3339 بالتوقيت العالمي المنسّق (UTC)
"الزولوية" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية:
{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
على سبيل المثال:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
تُرجع الطريقة قائمة بجلسات المشاركين، مرتبة حسب وقت الانضمام في
تنازليًا، كمثيل
مرجع واحد (conferenceRecords.participants.participantSession
)
يوضح نموذج الرمز البرمجي التالي كيفية سرد جميع جلسات المشاركين في سجل المؤتمر:
Java
Node.js
Python
استبدل القيمة الرئيسية باسم سجل المؤتمر اسم المشارك.
البحث عن جلسة مشارك معين
للبحث عن جلسة مشارك معين، استخدم
get()
على
conferenceRecords.participants.participantSessions
مورد يتضمّن معلَمة المسار name
. لاسترداد اسم
مشارك، استخدم الطريقة list()
.
تُرجع الطريقة اسم مشارك كمثيل لـ
مرجع واحد (conferenceRecords.participants.participantSessions
)
يعرض نموذج الرمز البرمجي التالي كيفية استرداد جلسة مشارِكة محدّدة:
Java
Node.js
Python
استبدل اسم المشارك باسم المشارك المحدد للبحث عنه.
استرداد تفاصيل المشاركين باستخدام People API
لاسترداد تفاصيل حول أحد المشاركين، استخدم
people.get
في
People API
- استخرِج رقم تعريف الشخص من اسم مورد المشارك باستخدام
المكون اللاحقة للمسار. على سبيل المثال، إذا كان اسم مورد المشارك
هو
conferenceRecords/abc-123/participants/12345
، الرقم التعريفي واجهة برمجة تطبيقات "الأشخاص" هي12345
. - تضمين المصادر
READ_SOURCE_TYPE_PROFILE
وREAD_SOURCE_TYPE_CONTACT
وREAD_SOURCE_TYPE_OTHER_CONTACT
. يضمن ذلك لكلا المستخدمين الداخليين يتم تضمين مؤسسة على 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