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

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

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

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

أحداث 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
• نظرة عامة على Meet REST API
• اختيار نطاقات Meet REST API
• برنامج تعليمي: مراقبة أحداث الاجتماعات باستخدام Python وMeet REST API