الاشتراك في أحداث Google Meet

توضِّح هذه الصفحة أحداث 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

google.workspace.meet.conference.v2.started

يبدأ المؤتمر في مساحة الاجتماع.

conferenceRecord

google.workspace.meet.conference.v2.ended

ينتهي المؤتمر في مساحة الاجتماع.

conferenceRecord

google.workspace.meet.participant.v2.joined

انضمام أحد المشاركين إلى مؤتمر نشط في مساحة الاجتماع

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

مغادرة أحد المشاركين مكالمة فيديو نشطة في مساحة الاجتماع

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

يتم إنشاء ملف تسجيل لمؤتمر في مساحة الاجتماع.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

يتم إنشاء ملف نص لمؤتمر في مساحة الاجتماع.

conferenceRecord.transcript

بيانات الحدث

يصف هذا القسم بيانات الأحداث وأمثلة على حمولات البيانات للأحداث في مساحات اجتماعات Meet.

عندما يتلقّى اشتراكك في Google Workspace حدثًا من Meet، يحتوي الحقل data على حمولة الحدث. تحتوي هذه الحمولة على معلومات حول مورد Google Workspace الذي تم تغييره. على سبيل المثال، إذا اشتركت في أحداث حول النصوص الجديدة في إحدى المساحات، ستتضمّن حمولة هذه الأحداث معلومات حول المورد transcript الذي تم تغييره.

بيانات الموارد في حمولة الحدث

يقدّم الجدول التالي أمثلة على حمولات JSON الأساسية للاشتراك في مساحة اجتماع Meet. تستخدم الأمثلة مؤتمر conferenceRecords/AAA-BBB-CCC-DDD-EEE الذي يتم إجراؤه في المساحة. لكل حدث يتلقّاه الاشتراك، تظهر الحمولة في الحقل data للحدث:

مثال نوع الحدث حمولة JSON

يبدأ المؤتمر في مساحة اجتماعات Meet.

google.workspace.meet.conference.v2.started

يتم استبعاد بيانات المورد.
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
انضمام أحد المشاركين إلى مؤتمر في مساحة اجتماعات Meet

google.workspace.meet.participant.v2.joined

يتم استبعاد بيانات المورد.
{
    "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"
    }
}