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

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

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

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

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

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

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

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

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

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

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

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

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

يتلقّى الاشتراك أحداثًا حول جميع مساحات الاجتماعات التي يكون فيها المستخدم مالكًا لمساحة الاجتماع. عادةً، يكون مالك مساحة الاجتماع هو أيضًا منظّم حدث "تقويم Google" المرتبط بمساحة الاجتماع.

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

عند إنشاء اشتراك في أحد موارد Meet، يمكنك استخدام الحقل eventTypes[] لتحديد أنواع الأحداث التي تريد تلقّيها. يتم تنسيق أنواع الأحداث وفقًا لمواصفات CloudEvents، مثل google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

على سبيل المثال، لتلقّي أحداث حول مشاركين جدد في اجتماع في مساحة Meet، عليك تحديد نوع الحدث على أنّه google.workspace.meet.participant.v2.joined. لمزيد من المعلومات حول طريقة عمل الأحداث، يمكنك الاطّلاع على بنية أحداث Google Workspace.

يعرض الجدول التالي أنواع الأحداث المتاحة للاشتراك في موارد 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.started conferenceRecord.recording
ينتهي تسجيل مؤتمر في مساحة الاجتماع. google.workspace.meet.recording.v2.ended conferenceRecord.recording
يتم إنشاء ملف تسجيل لاجتماع في مساحة الاجتماع. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
يبدأ إنشاء نص لاجتماع في مساحة الاجتماع. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
ينتهي نص المؤتمر في مساحة الاجتماع. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
يتم إنشاء ملف نصي لمؤتمر في مساحة الاجتماع. google.workspace.meet.transcript.v2.fileGenerated conferenceRecord.transcript

بيانات الأحداث

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

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

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

يقدّم الجدول التالي أمثلة على حمولات JSON للاشتراك في مساحة اجتماع في Meet. تستخدِم الأمثلة رقم تعريف سجلّ مكالمة الفيديو (على سبيل المثال، conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) لتحديد مساحة الاجتماع. لمزيد من المعلومات، يُرجى الاطّلاع على كيفية تحديد مساحة اجتماع في Meet.

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

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

يبدأ اجتماع أو ينتهي في مساحة اجتماع Meet.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

يستبعد بيانات الموارد:

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

يستبعد بيانات الموارد:

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
بدء تسجيل أو إنهاؤه أو إنشاء ملف لاجتماع في مساحة اجتماع Meet
  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

يستبعد بيانات الموارد:

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
بدء نص اجتماع أو إنهائه أو إنشاء ملف لاجتماع في مساحة اجتماع Meet
  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • google.workspace.meet.transcript.v2.fileGenerated

يستبعد بيانات الموارد:

{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

القيود
  • يمكن للمدعوين إلى حدث في "تقويم Google" والمشاركين الآخرين المدعوين إلى مكالمة فيديو تلقّي الأحداث التالية فقط: google.workspace.meet.conference.v2.started وgoogle.workspace.meet.transcript.v2.fileGenerated.