Gmail 動作

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

使用 Widget 處理常式函式附加至特定小工具的動作，該函式也會定義觸發動作的條件。觸發時，動作會執行指定的回呼函式。回呼函式會傳遞事件物件，該物件會攜帶使用者用戶端互動資訊。您必須實作回呼函式，並讓回呼函式傳回特定回應物件。

舉例來說，假設您希望按鈕在點選時建立並顯示新卡片。為此，您必須建立新的按鈕小工具，並使用按鈕小工具處理常式函式 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 會使用這個回應物件開啟並填入草稿撰寫視窗。

如需詳細資訊和範例，請參閱撰寫草稿訊息。