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

تصف هذه الصفحة أحداث Google Meet التي يمكن لتطبيقك الاشتراك فيها. باستخدام واجهة برمجة التطبيقات Google Workspace Events. بعد أن تقرر الأحداث التي تحتاج إليها، إنشاء اشتراكك لبدء تلقّيها فعالية 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 لواجهة برمجة تطبيقات REST API. للحصول على التفاصيل، يمكنك مراجعة الطريقة يحدِّد تطبيق Meet مساحة اجتماعات.
مستخدم //cloudidentity.googleapis.com/users/USER

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

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

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

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

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