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

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

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

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

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

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

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

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

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

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

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

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

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

يعرض الجدول التالي أنواع الأحداث المتوافقة مع الاشتراكات في موارد Meet:

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

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

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

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

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

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

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

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

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

المواضيع ذات الصلة

• نظرة عامة على Google Workspace Events API
• بنية أحداث Google Workspace
• اختيار نطاقات Google Workspace Events API
• نظرة عامة على Google Meet REST API
• اختيار نطاقات Meet REST API
• البرنامج التعليمي: مراقبة أحداث الاجتماعات باستخدام Python وواجهة برمجة تطبيقات Google Meet REST