يشرح هذا الدليل كيفية الحصول على تفاصيل حول المشاركين الذين حضروا مؤتمرًا سابقًا أو الذين يشاركون في مؤتمر نشط، بالإضافة إلى معلومات الجلسة، وذلك باستخدام Google Meet REST API.
المشارك هو مستخدم انضم إلى مكالمة أو يستخدم وضع المزاملة أو يشاهد كضيف أو جهاز غرفة متصل بمكالمة. يتوفّر مصدر
participants
واحد لكل شخص.
جلسة المشارِك هي رقم تعريف جلسة فريد يتم إنشاؤه لكل زوج من المشارِك والجهاز ينضم إلى مكالمة. يتوفّر مصدر
participantSessions
واحد لكل جلسة. إذا انضم المشارك إلى المكالمة نفسها عدة مرات من خلال الجهاز نفسه، سيتم تعيين أرقام تعريف جلسات فريدة لكل مرة.
إذا كنت مالكًا لمساحة اجتماع أو مشاركًا فيها، يمكنك استدعاء الطريقتَين get وlist في كل من الموردَين participants وparticipantSessions لاسترداد سجلات المشاركين.
تتيح المصادقة ومنح الإذن باستخدام بيانات اعتماد المستخدم لتطبيقات Google Meet الوصول إلى بيانات المستخدم وتنفيذ عمليات نيابةً عن المستخدم الذي تمت المصادقة عليه. يتيح لك المصادقة باستخدام التفويض على مستوى النطاق تفويض حساب خدمة أحد التطبيقات للوصول إلى بيانات المستخدمين بدون طلب موافقة كل مستخدم.
مشارك
توضّح الأقسام التالية كيفية الحصول على معلومات حول المشاركين في سجلّ مؤتمر.
تتحد موارد
participants
مع الحقل user. يمكن أن يكون user أحد الكائنات التالية فقط:
يكون
signedinUserإما:مستخدم ينضم من جهاز كمبيوتر شخصي أو جهاز جوّال أو من خلال "وضع المرافق"
حساب روبوت تستخدمه أجهزة غرف الاجتماعات
المستخدم
anonymousUserهو مستخدم مجهول الهوية لم يسجّل الدخول إلى حساب Google.phoneUserهو مستخدم يتصل من هاتف لا يمكن تحديد هويته لأنّه لم يسجّل الدخول باستخدام حساب Google.
يُرجى العِلم أنّه على الرغم من أنّ جميع العناصر الثلاثة تعرض displayName، تعرض signedinUser أيضًا معرّف user فريدًا يمكن تشغيله بشكل متوافق مع واجهة برمجة تطبيقات مدير SDK وPeople API. التنسيق: users/{user} لمزيد من المعلومات حول استخدام معرّف user
مع People API، يُرجى الاطّلاع على استرداد تفاصيل المشاركين باستخدام People API.
الحصول على تفاصيل حول مشارك
للحصول على تفاصيل حول مشارك معيّن، استخدِم طريقة
get
في المورد
participants. اضبط مَعلمة المسار name باستخدام التنسيق
conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
إذا كنت لا تعرف اسم المشارك، يمكنك إدراج جميع أسماء المشاركين باستخدام طريقة list.
يعرض الإجراء بيانات المشاركين كنموذج من مورد participants.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد لاعب معيّن:
جافا
Node.js
Python
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.
غيِّر القيم في السلسلة على الشكل التالي:
- اسم سجلّ مكالمة الفيديو مع اسم رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة الفيديو
- اسم المشارك مع اسم معرّف المشارك المحدّد في سجلّ المؤتمر
عرض قائمة بجميع المشاركين
لعرض تفاصيل عن جميع المشاركين في سجلّ مكالمة جماعية، استخدِم طريقة
list
في المورد
participants. اضبط مَعلمة المسار parent باستخدام التنسيق
conferenceRecords/{conferenceRecord}.
تعرض الطريقة قائمة بالمشاركين في الاجتماع، مرتّبة حسب
earliestStartTime بترتيب تنازلي، كنموذج من مورد participants. لتعديل حجم الصفحة وفلترة نتائج طلب البحث، اطّلِع على تخصيص تقسيم المحتوى إلى صفحات أو فلترة قائمة المشاركين.
توضح عينة التعليمات البرمجية التالية كيفية إدراج جميع المشاركين في سجل مؤتمر:
جافا
Node.js
Python
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.
استبدِل اسم العنصر الرئيسي باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر.
تخصيص تقسيم الصفحات أو فلترة قائمة المشاركين
مرِّر مَعلمات طلب البحث التالية لتخصيص تقسيم المشاركين إلى صفحات أو فلترتهم:
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 باستخدام التنسيق
conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.
إذا كنت لا تعرف اسم جلسة المشارك، يمكنك إدراج جميع جلسات المشارك باستخدام طريقة list.
يعرض الإجراء جلسة مشارك كنموذج من مورد participantSessions.
يوضّح عينة تعليمات برمجية التالي كيفية استرداد جلسة مشارك معيّنة:
جافا
Node.js
Python
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"
استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.
غيِّر القيم في السلسلة على الشكل التالي:
- اسم سجلّ مكالمة الفيديو مع اسم رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة الفيديو
- اسم المشارك مع اسم معرّف المشارك المحدّد في سجلّ المؤتمر
- معرّف جلسة المشارك مع معرّف جلسة المشارك المحدّدة
عرض جميع جلسات المشاركين
لعرض تفاصيل حول جميع جلسات أحد المشاركين في سجلّ اجتماع، استخدِم طريقة list في مورد participantSessions. اضبط مَعلمة المسار parent باستخدام التنسيق
conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
تعرض الطريقة قائمة بجلسات المشاركين، مرتّبة حسب startTime بترتيب تنازلي، كنموذج لمورد participantSession. لتعديل حجم الصفحة وفلترة نتائج طلب البحث، اطّلِع على تخصيص تقسيم الصفحات أو فلترة قائمة جلسات المشاركين.
تعرض عيّنة تعليمات برمجية التالية كيفية إدراج جميع جلسات المشاركين في سجلّ مؤتمر:
جافا
Node.js
Python
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.
غيِّر القيم في السلسلة على الشكل التالي:
- اسم سجلّ مكالمة الفيديو مع اسم رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة الفيديو
- اسم المشارك مع اسم معرّف المشارك المحدّد في سجلّ المؤتمر
تخصيص تقسيم الصفحات أو فلترة قائمة جلسات المشاركين
مرِّر مَعلمات طلب البحث الاختيارية التالية لتخصيص تقسيم الصفحات أو فلترة جلسات المشاركين:
pageSize: الحد الأقصى لعدد جلسات المشاركين المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 100 جلسة مشارك كحد أقصى. الحد الأقصى للقيمة هو 250، ويتم تلقائيًا تغيير القيم الأكبر من 250 إلى 250.pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم الرمز المميز هذا لاسترداد الصفحة التالية.
filter: اختياري. فلتر طلب بحث لاسترداد عناصر معيّنة في نتائج الموردparticipantSessions.يمكنك استخدام الحقلَين
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.