EventType

أنواع أحداث التفاعل مع التطبيقات في Google Chat.

لضبط تطبيقك في Chat لتلقّي أحداث التفاعل، يُرجى الاطّلاع على مقالة تلقّي تفاعلات المستخدمين والردّ عليها.

عمليات التعداد
UNSPECIFIED القيمة التلقائية للتعداد يُرجى عدم استخدامها.
MESSAGE

يرسل المستخدم رسالة إلى تطبيق Chat أو يستدعي تطبيق Chat في مساحة، مثلاً أي من الأمثلة التالية:

  • أي رسالة في مساحة الرسائل المباشرة باستخدام تطبيق Chat
  • رسالة في مساحة تضم عدة أشخاص حيث يشير شخص إلى تطبيق Chat باستخدام @أو يستخدم أحد الأوامر التي تبدأ بشرطة مائلة.
  • في حال ضبط معاينات الروابط لتطبيق Chat، ينشر المستخدم رسالة تحتوي على رابط يطابق نمط عنوان URL الذي تم ضبطه.
ADDED_TO_SPACE

إضافة مستخدم تطبيق Chat إلى مساحة أو يثبّت مشرف Google Workspace التطبيق في مساحات الرسائل المباشرة للمستخدمين في مؤسسته تردّ تطبيقات Chat عادةً على حدث التفاعل هذا من خلال نشر رسالة ترحيب في المساحة.

عندما يثبّت المشرفون تطبيقات Chat، يتم ضبط الحقل space.adminInstalled على true ولا يمكن للمستخدمين إلغاء تثبيتها. للتعرّف على تطبيقات Chat التي ثبَّتها المشرفون، يُرجى الاطّلاع على مستندات مساعدة مشرف Google Workspace، مقالة تثبيت تطبيقات Marketplace في نطاقك.

REMOVED_FROM_SPACE

يزيل مستخدم تطبيق Chat من مساحة، أو يلغي مشرف Google Workspace تطبيق Chat لمستخدم في مؤسسته. لا يمكن لتطبيقات Chat الردّ بإرسال رسائل إلى هذا الحدث، لأنّه سبق أن تمت إزالتها.

عندما يلغي المشرفون تثبيت تطبيقات Chat، يتم ضبط الحقل space.adminInstalled على false. إذا ثبَّت مستخدم تطبيق Chat قبل المشرف، يظل تطبيق Chat مثبّتًا لدى المستخدم ولا يتلقّى تطبيق Chat حدث تفاعل "REMOVED_FROM_SPACE".

CARD_CLICKED

ينقر المستخدم على عنصر تفاعلي في بطاقة أو مربّع حوار من تطبيق Chat، مثل زر. لتلقّي حدث تفاعل، يجب أن يؤدي الزر إلى بدء تفاعل آخر مع تطبيق Chat. على سبيل المثال، لا يتلقّى تطبيق في Chat حدث تفاعل CARD_CLICKED إذا نقر المستخدم على زر يفتح رابط موقع إلكتروني، ولكنه يتلقّى أحداث تفاعل في الأمثلة التالية:

  • ينقر المستخدم على زر "Send feedback" في بطاقة، ما يؤدي إلى فتح مربّع حوار لإدخال المعلومات.
  • ينقر المستخدم على زر "Submit" بعد إدخال المعلومات في بطاقة أو مربّع حوار.

إذا نقر مستخدم على زر لفتح مربّع حوار أو إرساله أو إلغائه، يتم ضبط الحقل isDialogEvent لحدث تفاعل CARD_CLICKED على true وسيتضمّن DialogEventType.

WIDGET_UPDATED يعدِّل أحد المستخدمين تطبيقًا مصغّرًا في رسالة بطاقة أو مربّع حوار.
APP_HOME

يفتح مستخدم رسالة مباشرة من تطبيق في Chat يستخدم الصفحة الرئيسية للتطبيق. لا يتم تضمين سوى الحقول type وuser وspace للأحداث من هذا النوع. لمزيد من المعلومات، راجِع إنشاء صفحة رئيسية لتطبيق Google Chat.

SUBMIT_FORM

مستخدِم يرسل معلومات في بطاقة الصفحة الرئيسية للتطبيق لا يتم تضمين سوى الحقول type وuser وspace للأحداث من هذا النوع. لمزيد من المعلومات، راجِع إنشاء صفحة رئيسية لتطبيق Google Chat.