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

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

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

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

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

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

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

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

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

يصنّف 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 في المستندات المرجعية.

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