توضِّح هذه الصفحة أحداث Google Meet التي يمكن لتطبيقك الاشتراك فيها باستخدام واجهة برمجة تطبيقات أحداث Google Workspace. بعد تحديد أنواع الأحداث التي تحتاج إليها، يمكنك إنشاء اشتراك لبدء تلقّي الأحداث من Google Meet.
لمزيد من المعلومات حول تطوير التطبيقات لـ Google Meet، يُرجى الاطّلاع على نظرة عامة على واجهة برمجة تطبيقات Google Meet REST.
الموارد المستهدَفة المتوافقة مع Meet
لتلقّي أحداث Meet، تتيح Google Workspace Events API للاشتراكات في الموارد التالية:
- مساحات الاجتماعات، يتم تمثيلها كموارد
space
. - المستخدمون، الذين يتم تمثيلهم كموارد
user
في Cloud Identity API.
أحداث Meet المتوافقة
تتيح لك اشتراكات Google Workspace تلقّي أحداث حول الأنواع التالية من التغييرات في Meet:
- يبدأ المؤتمر أو ينتهي في مساحة اجتماع.
- ينضم مشارك إلى مؤتمر أو يغادره.
- يتم إنشاء تسجيل لمؤتمر فيديو.
- يتم إنشاء نص لمؤتمر.
عند إنشاء اشتراك في مورد Meet، يمكنك استخدام الحقل
eventTypes[]
لتحديد أنواع الأحداث التي تريد تلقّيها. يتم تنسيق أنواع الأحداث
وفقًا لمواصفات CloudEvent، مثل
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
.
على سبيل المثال، لتلقّي أحداث حول المشاركين الجدد في مؤتمر
لمساحة Meet، يمكنك تحديد نوع الحدث على أنّه
google.workspace.meet.participant.v2.joined
. لمزيد من المعلومات عن آلية عمل الأحداث،
يُرجى الاطّلاع على بنية أحداث Google Workspace.
يعرض الجدول التالي أنواع الأحداث المتوافقة والوصف ومورد Meet الذي تم تغييره والممثل في بيانات الحدث:
نوع الحدث | الوصف | مرجع Meet |
---|---|---|
|
يبدأ المؤتمر في مساحة الاجتماع. |
|
|
ينتهي المؤتمر في مساحة الاجتماع. |
|
|
انضمام أحد المشاركين إلى مؤتمر نشط في مساحة الاجتماع |
|
|
مغادرة أحد المشاركين مكالمة فيديو نشطة في مساحة الاجتماع |
|
|
يتم إنشاء ملف تسجيل لمؤتمر في مساحة الاجتماع. |
|
|
يتم إنشاء ملف نص لمؤتمر في مساحة الاجتماع. |
|
بيانات الحدث
يصف هذا القسم بيانات الأحداث وأمثلة على حمولات البيانات للأحداث في مساحات اجتماعات Meet.
عندما يتلقّى اشتراكك في Google Workspace حدثًا من
Meet، يحتوي الحقل
data
على حمولة الحدث. تحتوي هذه الحمولة على معلومات حول مورد Google Workspace الذي تم تغييره. على سبيل المثال، إذا اشتركت في أحداث حول النصوص الجديدة في إحدى المساحات، ستتضمّن حمولة هذه الأحداث معلومات حول المورد transcript
الذي تم تغييره.
بيانات الموارد في حمولة الحدث
يقدّم الجدول التالي أمثلة على حمولات JSON الأساسية للاشتراك في مساحة اجتماع Meet. تستخدم الأمثلة مؤتمر conferenceRecords/AAA-BBB-CCC-DDD-EEE
الذي يتم إجراؤه في المساحة. لكل حدث يتلقّاه الاشتراك، تظهر الحمولة في الحقل data
للحدث:
مثال | نوع الحدث | حمولة JSON |
---|---|---|
يبدأ المؤتمر في مساحة اجتماعات Meet. |
|
يتم استبعاد بيانات المورد.
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
انضمام أحد المشاركين إلى مؤتمر في مساحة اجتماعات Meet |
|
يتم استبعاد بيانات المورد.
{ "participantSession": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP" } } |
يتم إنشاء تسجيل لمكالمة فيديو في مساحة اجتماعات Meet. | google.workspace.meet.recording.v2.fileGenerated |
يتم استبعاد بيانات المورد.
{ "recording": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP" } } |
يتم إنشاء نص لمكالمة فيديو في مساحة اجتماعات Meet. | google.workspace.meet.transcript.v2.fileGenerated |
يتم استبعاد بيانات المورد.
{ "transcript": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT" } } |
مواضيع ذات صلة
- برنامج تعليمي: مراقبة أحداث الاجتماعات باستخدام Python وGoogle Meet REST API
- بنية أحداث Google Workspace
- اختيار نطاقات OAuth
- يمكنك إنشاء اشتراك لتلقّي أحداث Meet
- نظرة عامة حول Google Meet REST API