Gmail 動作

Action 物件可讓您在 Google Workspace 外掛程式中建構互動式行為。這些函式會定義使用者與外掛程式 UI 中的小工具 (例如按鈕) 互動時發生的情況。

動作會使用小工具處理常式函式附加至指定小工具，該函式也會定義觸發動作的條件。觸發時，動作會執行指定的回呼函式。回呼函式會收到 event 物件，其中包含使用者在用戶端互動的相關資訊。您必須實作回呼函式，並讓該函式傳回特定回應物件。

舉例來說，假設您想要在點選按鈕時建構並顯示新資訊卡，為此，您必須建立新的按鈕小工具，並使用按鈕小工具處理常式函式 setOnClickAction(action) 設定建構資訊卡 Action。您定義的 Action 會指定在點選按鈕時執行的 Apps Script 回呼函式。在這種情況下，您會實作回呼函式來建構所需資訊卡，並傳回 ActionResponse 物件。回應物件會指示外掛程式顯示回呼函式建構的資訊卡。

本頁面說明您可以在外掛程式中加入的 Gmail 專屬小工具動作。

Gmail 互動

擴充 Gmail 的 Google Workspace 外掛程式可以包含額外的 Gmail 專用小工具動作，用於撰寫郵件草稿。這項動作需要相關動作的回呼函式傳回專屬的回應物件：

嘗試執行的動作	回呼函式應會傳回
撰寫郵件草稿	ComposeActionResponse

如要使用這些小工具動作和回應物件，Google Workspace 外掛程式必須在資訊清單中加入 https://www.googleapis.com/auth/gmail.addons.current.action.compose scope。

撰寫訊息

擴充 Gmail 的外掛程式可以定義小工具，使用者與小工具互動時，系統會在 Gmail 中產生草稿郵件 (新郵件或回覆)。如要執行這項操作，請將觸發小工具與會傳回 ComposeActionResponse 物件的回呼函式建立關聯。回呼函式執行完畢後，Gmail 會使用這個回應物件開啟並填入草稿撰寫視窗。

如需更多詳細資料和範例，請參閱「撰寫草稿訊息」。