يوضّح هذا الدليل كيفية الحصول على تفاصيل عن المشاركين الذين حضروا اجتماعًا سابقًا أو يشاركون في اجتماع نشط، بالإضافة إلى معلومات جلساتهم، باستخدام Google Meet REST API.
المشارك هو شخص انضم إلى
مكالمة أو يستخدم وضع
المزاملة، أو يشاهد المكالمة كمشاهد، أو
جهاز غرفة متصل بمكالمة. يتوفّر مرجع واحد
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
: اختياري. فلتر طلب بحث لاسترداد عناصر معيّنة في resultsparticipants
المرجعيمكنك استخدام الحقلَين
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
: اختياري. فلتر طلب بحث لاسترداد عناصر معيّنة في resultsparticipants
المرجعيمكنك استخدام الحقلَين
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
.