توضّح هذه الصفحة كيف يمكن لتطبيقات Google Chat تلقّي الأحداث في Google Chat والاستجابة لها.
يمثّل حدث Google Chat نشاطًا أو تغييرًا في Chat، مثل رسالة جديدة في مساحة. يمكن لتطبيق Chat استخدام الأحداث لفهم ما حدث واتّخاذ الإجراءات أو الاستجابة بطريقة مفيدة للمستخدمين.
إليك بعض الأمثلة حول كيفية استخدام الأحداث:
- يمكنك تتبُّع الرسائل الجديدة في مساحة والرد عليها، مثل البحث عن كلمات أو عبارات رئيسية.
- أرسِل رسالة ترحيب إلى المستخدمين عند انضمامهم إلى المساحة، وذلك لشرح إرشادات المساحة أو مشاركة نصائح حول كيفية استخدام تطبيق Chat بفعالية.
- تتبُّع نشاط Chat وتحليله على سبيل المثال، لإرسال تقرير شهري عن الأعضاء الجدد أو الرسائل التي تتلقّى أكبر عدد من التفاعلات أو الردود.
- التواصل عبر منصات المراسلة: على سبيل المثال، يمكن للمستخدمين إرسال الرسائل واستلامها من مستخدمين من منصة مراسلة مختلفة بدون مغادرة Chat.
آلية عمل الأحداث
كلما حدث ما في Google Chat، يتم إنشاء مورد Google Chat API أو تحديثه أو حذفه. تقدم الأحداث معلومات حول وقت حدوث النشاط ومورد Chat API المتأثر به.
يتم تصنيف الأحداث حسب نوعها في Chat. وتساعدك أنواع الأحداث على فلترة نوع المعلومات التي تحتاج إليها وطلبها فقط، وتتيح لك معالجة الأحداث المماثلة بالطريقة نفسها.
يعرض الجدول التالي كيفية تأثير نشاط في Chat في مورد Chat API ذي صلة ونوع الحدث الذي يتلقّاه تطبيق Chat:
| النشاط | مرجع Chat API | نوع الحدث |
|---|---|---|
نشر مستخدم رسالة في مساحة Chat |
يتم إنشاء مورد Message. |
رسالة جديدة |
| يصبح المستخدم مدير مساحة. | تم تعديل مورد Membership. |
تم تعديل العضوية. |
| يتفاعل مستخدم مع رسالة | يتم إنشاء مورد Reaction. |
تفاعل جديد |
| مغادرة مستخدم للمساحة | تم حذف مورد Membership. |
تم حذف العضوية |
تلقّي الأحداث من Google Chat
لتلقّي الأحداث، يمكن لتطبيق Chat تنفيذ أي مما يلي:
- يمكنك الاشتراك في الأحداث باستخدام Google Workspace Events API لتلقّي الأحداث عند حدوثها.
- طلب البحث عن الأحداث من خلال طلب Chat API
توفِّر Google Workspace Events API وChat API أنواع الأحداث نفسها. لفهم ما إذا كان يجب عليك الاشتراك في الأحداث أو الاستعلام عنها، راجع الجدول التالي:
| الاشتراك في الأحداث | طلب بحث للأحداث | |
|---|---|---|
| حالات الاستخدام |
|
|
| API | واجهة برمجة التطبيقات لفعاليات Google Workspace | واجهة برمجة التطبيقات للدردشة |
| مصدر الأحداث | المساحات والمستخدمون | المساحات فقط |
| تنسيق الحدث | رسالة Google Cloud Pub/Sub، يتم تنسيقها وفقًا لمواصفات CloudEvent. لمعرفة التفاصيل، يُرجى الاطّلاع على بنية أحداث Google Workspace. |
مرجع في Chat API
(
spaces.spaceEvent)
|
| بيانات الحدث | سلسلة Base64 مرمّزة تتضمّن بيانات الموارد أو بدونها مثلاً، الحمولات، اطّلِع على بيانات الأحداث. | حمولة JSON التي تحتوي على بيانات المورد. لا تتضمّن بعض أنواع الأحداث سوى حقول موارد معيّنة. على سبيل المثال، الحمولات، اطّلِع على المستندات المرجعية لـ SpaceEvents. |
للتعرّف على كيفية إنشاء الاشتراكات باستخدام Google Workspace Events API، راجِع مستندات واجهة برمجة تطبيقات أحداث Google Workspace. لطلب البحث عن الأحداث باستخدام Chat API، يُرجى الاطّلاع على الأدلة التالية:
القيود
-
بالنسبة إلى الاشتراكات المخصّصة للمستخدمين، لا يتم بدء الأحداث المتعلّقة بالأعضاء الجدد في الرسائل المباشرة أو المحادثات الجماعية بدون اسم (
google.workspace.chat.membership.v1.created) إلا بعد نشر الرسالة الأولى. - لا تؤدي التغييرات في سجلّ المساحات إلى بدء أحداث المساحة المعدَّلة (نوع الحدث:
google.workspace.chat.spaces.v1.updated). - لتلقّي أحداث العضوية، يجب أن يكون المستخدم عضوًا مباشرًا في المساحة. في حال إضافة مستخدم أو تعديله أو إزالته بشكل غير مباشر إلى مساحة من خلال "مجموعة Google"، لن يتلقّى الاشتراك أحداث الاشتراك هذه. للتعرّف على آلية عمل عضويات "مجموعات Google"، يمكنك الاطّلاع على إضافة مجموعة Google إلى مساحة.