الرد على الأحداث من Google Meet

يوضّح هذا المستند كيفية تلقّي أحداث Google Meet والردّ عليها من خلال خدمة Google Cloud Pub/Sub.

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

في ما يلي بعض الأمثلة على كيفية استخدام الأحداث:

  • مراقبة التغييرات في الاجتماع والردّ عليها، مثل بدء الاجتماع أو انتهائه

  • تتبُّع المستخدمين الذين حضروا الاجتماع لأغراض تنظيمية أو تدريبية

  • الاستماع إلى نص الاجتماع ليتم تحليل محتوى الملف وتسجيله في نظام إدارة علاقات العملاء أو قاعدة البيانات

طريقة عمل الأحداث

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

مثال على كيفية تفعيل حدث من خلال مساحة اجتماع جديدة
الشكل 1. ينشئ المستخدم مساحة اجتماع، ما يؤدي إلى إنشاء مورد Space. ينشئ Meet بعد ذلك حدثًا يتضمّن بيانات حول مساحة الاجتماع الجديدة.

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

يوضّح المثال التالي كيف يؤثّر نشاط في Meet في مصدر ذي صلة في Meet REST API، ونوع الحدث الذي يتلقّاه تطبيق Meet:

النشاط مورد Meet REST API نوع الحدث
ينضم مستخدم إلى مساحة اجتماع. يتم إنشاء مورد ConferenceRecord. سجلّ مكالمة فيديو جديد

تلقّي بيانات الأحداث من Google Meet

لتلقّي بيانات الأحداث، يمكن لتطبيقك إجراء أيّ مما يلي:

يوضّح الجدول التالي الفرق بين الاشتراك في الأحداث والاستعلام عنها وأسباب ذلك:

الاشتراك في الأحداث طلب البيانات
حالات الاستخدام
  • معالجة الأحداث أو الردّ عليها في الوقت الفعلي
  • تتبُّع التغييرات في الموارد لتحسين أداء تطبيقك
  • استرداد البيانات يدويًا
  • استرداد جميع البيانات من Meet (بسبب انقطاع الخدمة أو عدم نشاط الاشتراك)
واجهة برمجة التطبيقات واجهة برمجة التطبيقات لفعاليات Google Workspace Meet REST API
مصدر الأحداث سجلّ المؤتمر والمستخدمون المساحة وسجلّ الاجتماعات
الأحداث المتوافقة سجلّ المؤتمر

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

للحصول على قائمة بنقاط النهاية المتوافقة، يُرجى الاطّلاع على المورد Space والمورد ConferenceRecord في مستندات واجهة برمجة تطبيقات Meet REST.
تنسيق الحدث رسالة Google Cloud Pub/Sub منسَّقة وفقًا لمواصفات CloudEvent لمزيد من التفاصيل، يُرجى الاطّلاع على بنية أحداث Google Workspace. أحد موارد Meet REST API (Space وConferenceRecord)
بيانات الأحداث سلسلة مرمّزة باستخدام Base64 تتضمّن بيانات المورد أو لا تتضمّنها للاطّلاع على أمثلة على حمولات البيانات، راجِع بيانات الأحداث. حِمل JSON يحتوي على بيانات الموارد. للاطّلاع على مثال عن حمولة، راجِع مورد ConferenceRecord في المستندات المرجعية.

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

في هذا المثال، يريد تطبيق Meet تلقّي معلومات حول التغييرات التي تطرأ على المشاركين في مساحة اجتماع. في مساحة الاجتماع، ينضم أحد المشاركين إلى اجتماع نشط، ما يؤدي إلى إنشاء مورد ParticipantSession وبدء حدث جديد. يمكنك بعد ذلك الحصول على معلومات حول هذه الأحداث باستخدام الطريقتَين subscribe أو query.

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

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

تطبيق Meet يشترك في أحداث المشاركين باستخدام Google Workspace Events API.
الشكل 2. يتلقّى تطبيق Meet أحداث المشاركين من خلال اشتراك باستخدام Google Workspace Events API.

في الشكل 2، يتضمّن تطبيق Meet اشتراكًا نشطًا في مساحة الاجتماع، وبالتالي يتلقّى التطبيق حدثًا كلما تغيّرت جلسة أحد المشاركين في مساحة الاجتماع. يمكن لتطبيق Meet بعد ذلك الاستجابة في الوقت الفعلي لأي من الأنشطة، مثل معرفة وقت انضمام مشارك إلى مؤتمر نشط أو مغادرته.

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

طلب البحث عن الأحداث الأخيرة

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

تطبيق Meet يطلب أحداث المشاركين باستخدام واجهة Meet REST API.
الشكل 3. يتلقّى تطبيق Meet أحداث المشاركين الحديثة من خلال طلب البحث عن أحداث مساحة الاجتماع باستخدام واجهة برمجة تطبيقات Meet REST.

في الشكل 3، يستدعي تطبيق Meet طريقة Meet REST API conferenceRecords.participants.participantSessions.list بعد حدوث جميع أنشطة جلسة المشاركين. تعرض واجهة برمجة تطبيقات REST الخاصة بـ Meet قائمة بموارد ParticipantSession تمثّل كل تغيير. يمكن لتطبيق Meet بعد ذلك معالجة البيانات أو الردّ استنادًا إلى النشاط الأخير، مثل إنشاء قائمة بالمشاركين الذين انضموا إلى المؤتمر وخرجوا منه.

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

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