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

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

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

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

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

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

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

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

عند حدوث أي شيء في Google Meet، يتم إنشاء مورد Google Meet REST API أو تعديله. يستخدم 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 API.

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

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

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