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

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

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

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

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

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

الموارد التي يمكنك مراقبة الأحداث فيها

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

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

المورد المستهدف التنسيق القيود (إذا كان ذلك منطبقًا)
مساحة الاجتماع //meet.googleapis.com/spaces/SPACE

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

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

يتلقّى الاشتراك أحداثًا حول جميع مساحات الاجتماعات التي يكون فيها المستخدم هو مالك مساحة الاجتماع. عادةً، يكون مالك مساحة الاجتماع هو أيضًا منظّم حدث "تقويم 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) لتحديد مساحة الاجتماع. لمزيد من المعلومات، يُرجى الاطّلاع على كيفية تحديد مساحة اجتماع في Meet.

بالنسبة إلى كل حدث تتلقّاه الاشتراك، يظهر الحمولة في الحقل data الخاص بالحدث:

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

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

google.workspace.meet.conference.v2.started
لا يشمل بيانات الموارد
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
ينضم أحد المشاركين إلى مؤتمر في مساحة اجتماع Meet.

google.workspace.meet.participant.v2.joined
لا يشمل بيانات الموارد
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
يتم إنشاء تسجيل لمؤتمر في مساحة اجتماع Meet. google.workspace.meet.recording.v2.fileGenerated
لا يشمل بيانات الموارد
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
يتم إنشاء نص لاجتماع في مساحة الاجتماع في Meet. google.workspace.meet.transcript.v2.fileGenerated
لا يشمل بيانات الموارد
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}