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 會使用這個回應物件開啟並填入撰寫草稿的撰寫視窗。
如需瞭解詳情和範例,請參閱「撰寫郵件草稿」。