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

توضّح هذه الصفحة أحداث Google Meet التي يمكن لتطبيقك الاشتراك فيها باستخدام واجهة برمجة التطبيقات Google Workspace Events API. بعد تحديد أنواع الأحداث التي تحتاج إليها، يمكنك إنشاء اشتراك لبدء تلقّي الأحداث من Google Meet.

للتعرّف على مزيد من المعلومات حول تطوير تطبيقات لتطبيق Google Meet، يُرجى الاطّلاع على نظرة عامة على واجهة برمجة التطبيقات Google Meet REST API.

أحداث Meet المتوافقة

تتيح لك اشتراكات Google Workspace تلقّي أحداث بشأن الأنواع التالية من التغييرات في Meet:

  • يبدأ المؤتمر أو ينتهي في مساحة اجتماع.
  • انضمام أحد المشاركين إلى مؤتمر أو مغادرته
  • يتم إنشاء تسجيل لمكالمة جماعية.
  • يتم إنشاء نص لمكالمة جماعية.

الموارد التي يمكنك رصدها بحثًا عن الأحداث

لتلقّي الأحداث، عليك تحديد مورد Meet المطلوب مراقبته، وهو ما يُعرف باسم المورد المستهدَف للاشتراك.

تتوافق Google Workspace Events API مع الموارد المستهدَفة التالية لتطبيق Meet:

المورد المستهدَف التنسيق القيود (إن وُجدت)
مساحة الاجتماع //meet.googleapis.com/spaces/SPACE

حيث يكون SPACE هو المعرّف في اسم المورد لمورد space في Meet REST API. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة كيفية تحديد Meet لمساحة اجتماع.
المستخدم //cloudidentity.googleapis.com/users/USER

حيث يكون USER هو رقم التعريف في حقل signedinUser.user لمورد participant في Meet REST API. لمعرفة التفاصيل، يُرجى الاطّلاع على العمل مع المشاركين.

يتلقّى الاشتراك أحداثًا عن مساحات الاجتماعات التي يكون فيها المستخدم أحد ما يلي:

  • مالك مساحة الاجتماعات
  • المُنظِّم لحدث "تقويم Google" المرتبط بمساحة الاجتماع.

أنواع الأحداث لإنشاء الاشتراكات

عند إنشاء اشتراك لمصدر Meet، استخدِم الحقل eventTypes[] لتحديد أنواع الأحداث التي تريد تلقّيها. يتم تنسيق أنواع الأحداث وفقًا لمواصفات CloudEvents، مثل 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"
    }
}