المشارك هو شخص انضم إلى
مكالمة أو يستخدم وضع
المزاملة، أو يشاهد المكالمة كمشاهد، أو
جهاز غرفة متصل بمكالمة. يتوفّر مرجع واحد
conferenceRecords.participants
لكل مستخدم.
جلسة أحد المشاركين هي
رقم تعريف جلسة فريد يتم إنشاؤه لكل زوج من المشاركين والأجهزة ينضم إلى مكالمة.
يتوفّر مصدر واحد
conferenceRecords.participants.participantSessions
لكل جلسة. إذا انضمّ المشارك إلى المكالمة نفسها عدة مرات
من الجهاز نفسه، يتم منح كل مشارك معرّفات جلسات فريدة.
توضِّح هذه الصفحة كيفية الحصول على معلومات عن جميع المشاركين الذين حضروا أو يشاركون في مكالمة فيديو، أو عن مشارك واحد فقط، بالإضافة إلى معلومات الجلسة.
مشارك
توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات عن المشاركين.
يتضمّن المورد
conferenceRecords.participants
الحقل user
. يمكن أن يكون العنصر user
أحد يليه فقط:
signedinUser
يمكن أن يكون:شخص ينضم من جهاز كمبيوتر شخصي أو جهاز جوّال أو من خلال وضع "الشخص المصاحب"
حساب روبوت يستخدمه أجهزة غرف المؤتمرات
anonymousUser
هو مستخدم مجهول لم يسجّل الدخول إلى حساب Google.phoneUser
هو مستخدم يتصل من هاتف لا يمكن تحديد هويته لأنّه لم يسجّل الدخول باستخدام حساب Google.
البحث عن جميع المشاركين
للحصول على تفاصيل عن جميع المشاركين في سجلّ مؤتمر، استخدِم الأسلوب
list()
في مورد
conferenceRecords.participants
مع مَعلمة المسار parent
.
يمكنك استخدام الحقلَين earliestStartTime
أو latestEndTime
لفلترة المحتوى حسب
المستخدِمين الذين انضموا قبل وقت معيّن أو غادروا بعد وقت معيّن. يستخدم كلا الحقلين تنسيق
الطابع الزمني
بتنسيق RFC 3339
التوقيت العالمي المنسق (UTC) "زولو"، مع دقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام عشرية:
{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
، يكون رقم تعريف واجهة برمجة التطبيقات People API هو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