يرسل أحد المستخدمين رسالة إلى تطبيق Chat أو يشغّل تطبيق Chat في مساحة، مثل أيّ من الأمثلة التالية:
أي رسالة في مساحة رسالة مباشرة (DM) باستخدام تطبيق 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، يتم ضبط الحقل 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_COMMAND
يُطلِق مستخدم أمرًا في التطبيق.
APP_HOME
يفتح مستخدم رسالة مباشرة من تطبيق Chat يستخدم شاشة التطبيق الرئيسية. لا يتم تضمين سوى الحقول type وuser وspace للأحداث من هذا النوع. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء صفحة رئيسية لتطبيق Google Chat.
SUBMIT_FORM
يُرسل مستخدم معلومات في بطاقة الصفحة الرئيسية للتطبيق. لا يتم تضمين سوى الحقول type وuser وspace للأحداث من هذا النوع. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء صفحة رئيسية لتطبيق Google Chat.
تاريخ التعديل الأخير: 2024-12-17 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-12-17 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Google Chat app interaction events are triggered by various user actions, such as sending messages, adding/removing the app, interacting with cards, and updating widgets."],["These events provide context about the interaction, like the user, space, and specific action taken, allowing your app to respond appropriately."],["`ADDED_TO_SPACE` and `REMOVED_FROM_SPACE` events help manage the app's presence in spaces, while `CARD_CLICKED` enables handling user interactions with card elements."],["`MESSAGE` events cover various scenarios, including direct messages, @mentions, slash commands, and link previews, enabling diverse app functionalities."],["`APP_HOME` and `SUBMIT_FORM` events allow for interactions specific to apps that utilize the app home feature for a more integrated experience within Google Chat."]]],[]]
