Action
物件可讓您建構互動式
行為嵌入 Google Workspace 外掛程式會定義
使用者在
外掛程式 UI
您可以使用 小工具處理常式函式, 這也會定義觸發動作的條件。觸發後 就會執行 回呼函式。 回呼函式會經由 事件物件, 使用者的用戶端互動相關資訊。您必須將 回呼函式並使其傳回特定回應物件。
舉例來說,假設您想新增一個按鈕,並在
點擊。為此,您必須建立新的按鈕小工具,並使用按鈕小工具
處理常式函式
setOnClickAction(action)
敬上
設定卡片建構 Action
。
您定義的 Action
指定了 Apps Script
使用者點選按鈕時執行的回呼函式。在這個範例中
實作回呼函式來建構所需卡片,並傳回
ActionResponse
敬上
物件。回應物件會指示外掛程式顯示回呼
函式
本頁說明 Gmail 專屬的小工具動作,您可以將這些小工具動作加入 外掛程式。
Gmail 互動
擴充 Gmail 的 Google Workspace 外掛程式可能包含 還提供額外的 Gmail 專用小工具操作,可用來撰寫郵件草稿。這個 動作需要相關的動作 回呼函式 傳回特殊的回應物件:
已嘗試操作 | 回呼函式應傳回 |
---|---|
撰寫訊息草稿 | ComposeActionResponse |
如要使用這些小工具動作和回應物件,外掛程式必須
加入
https://www.googleapis.com/auth/gmail.addons.current.action.compose
範圍。
撰寫郵件
擴充 Gmail 的 Google Workspace 外掛程式
定義小工具,在互動後在 Gmail 中產生郵件草稿
(新郵件或回覆皆可)。如要進行這項操作,您必須與
小工具,其中包含可傳回
ComposeActionResponse
敬上
物件。當回呼函式執行完畢時,Gmail 會使用這個
回應物件,以開啟並填入撰寫視窗草稿。
如需詳細資訊和範例,請參閱: 撰寫郵件草稿。