يرسل مستخدم رسالة إلى تطبيق 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
يستخدم أحد المستخدمين أمرًا في تطبيق Chat، بما في ذلك الأوامر التي تبدأ بشرطة مائلة والأوامر السريعة.
APP_HOME
يفتح المستخدم رسالة مباشرة من تطبيق Chat يستخدم ميزة "الصفحة الرئيسية للتطبيق". يتم تضمين الحقول type وuser وspace فقط للأحداث من هذا النوع. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إنشاء صفحة رئيسية لتطبيق Google Chat.
SUBMIT_FORM
يرسل المستخدم معلومات في بطاقة الصفحة الرئيسية للتطبيق. يتم تضمين الحقول type وuser وspace فقط للأحداث من هذا النوع. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إنشاء صفحة رئيسية لتطبيق Google Chat.
تاريخ التعديل الأخير: 2025-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-09-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Chat app interaction events are triggered by various user actions, such as sending messages, adding/removing the app, interacting with cards, and updating widgets.\u003c/p\u003e\n"],["\u003cp\u003eThese events provide context about the interaction, like the user, space, and specific action taken, allowing your app to respond appropriately.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eADDED_TO_SPACE\u003c/code\u003e and \u003ccode\u003eREMOVED_FROM_SPACE\u003c/code\u003e events help manage the app's presence in spaces, while \u003ccode\u003eCARD_CLICKED\u003c/code\u003e enables handling user interactions with card elements.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eMESSAGE\u003c/code\u003e events cover various scenarios, including direct messages, @mentions, slash commands, and link previews, enabling diverse app functionalities.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAPP_HOME\u003c/code\u003e and \u003ccode\u003eSUBMIT_FORM\u003c/code\u003e events allow for interactions specific to apps that utilize the app home feature for a more integrated experience within Google Chat.\u003c/p\u003e\n"]]],["Google Chat apps can receive various interaction events. These include `MESSAGE` (user messages or @mentions), `ADDED_TO_SPACE` (app added to space), `REMOVED_FROM_SPACE` (app removed), `CARD_CLICKED` (user clicks a card element), `WIDGET_UPDATED` (widget update), `APP_COMMAND` (user command), `APP_HOME` (user opens app home), and `SUBMIT_FORM` (user submits app home card). Each event triggers specific app actions, like posting welcome messages or responding to user input.\n"],null,[]]
