Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
EventType
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
| 列舉 |
UNSPECIFIED |
列舉的預設值。請勿使用。 |
MESSAGE |
使用者傳送訊息給 Chat 應用程式,或在聊天室中叫用 Chat 應用程式。訊息事件範例如下:
- 與 Chat 應用程式的即時訊息 (DM) 聊天室中的任何訊息。
- 在多人聊天室中,使用者 @提及 Chat 應用程式,或使用其中一個斜線指令。
- 如果已為 Chat 應用程式設定連結預覽功能,使用者發布的訊息包含符合設定網址模式的連結。
|
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 應用程式,該應用程式仍會保留在裝置上,且不會收到 REMOVED_FROM_SPACE 互動事件。 |
CARD_CLICKED |
使用者點選 Google Chat 應用程式中資訊卡或對話方塊的互動式元素,例如按鈕。如要接收互動事件,按鈕必須觸發與 Chat 擴充應用程式的另一次互動。舉例來說,如果使用者點選按鈕開啟網站連結,Chat 擴充應用程式不會收到 CARD_CLICKED 互動事件,但會收到下列互動事件:
- 使用者點選資訊卡上的
Send feedback 按鈕,開啟對話方塊並輸入資訊。
- 使用者在卡片或對話方塊中輸入資訊後,點選
Submit 按鈕。
如果使用者點選按鈕開啟、提交或取消對話方塊,CARD_CLICKED 互動事件的 isDialogEvent 欄位會設為 true,並包含 DialogEventType。 |
WIDGET_UPDATED |
使用者更新資訊卡訊息或對話方塊中的小工具。當使用者與有相關聯動作的小工具互動時,就會觸發這個事件。 |
APP_COMMAND |
使用者使用 Chat 應用程式指令,包括斜線指令和快速指令。 |
APP_HOME |
使用者透過使用應用程式主頁的 Chat 應用程式開啟即時訊息。這類事件只會包含 type、user 和 space 欄位。詳情請參閱「為 Google Chat 應用程式建立首頁」。 |
SUBMIT_FORM |
使用者在應用程式主畫面資訊卡中提交資訊。這類事件只會包含 type、user 和 space 欄位。詳情請參閱「為 Google Chat 應用程式建立首頁」。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-09-12 (世界標準時間)。
[null,null,["上次更新時間:2025-09-12 (世界標準時間)。"],[],["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"]]