Apps Script 觸發條件造成指定的指令碼 函式 (觸發條件函式),每當有指定事件時就會執行 會發生什麼事只有特定事件才會觸發觸發條件;而且 Google Workspace 應用程式支援不同的事件組合。
觸發條件啟動時,系統會建立事件物件。這種 JSON 結構 當中包含已發生事件的詳細資料。事件中的資訊 物件結構會根據觸發條件類型以不同方式排列。
事件物件建立完成後,Apps Script 會將該物件以參數形式傳遞至 觸發函式。觸發函式是一種回呼函式,您必須 以便採取任何適當行動來回應 活動。例如,在 可以擴充 Gmail 的 Google Workspace 外掛程式,您可以 定義觸發條件,以在使用者開啟訊息時建立新的資訊卡介面 。在這種情況下,您可以實作關聯回呼函式來建立 這些資訊卡是由 事件物件。
本頁面提供在 Google Workspace 外掛程式專案
資訊清單觸發條件
與「編輯器外掛程式」不同,Google Workspace 外掛程式 目前無法使用 Apps Script 簡易觸發條件 而是使用專為達成此目標而設計的觸發條件 Google Workspace 外掛程式:資訊清單觸發條件。
資訊清單觸發條件是在 Google Workspace 外掛程式 manifest。資訊清單觸發條件的例子包括 包括:
- 建構並顯示外掛程式首頁的首頁觸發條件。
- 會顯示新資訊卡或接收日曆活動的觸發條件 使用者開啟日曆活動時,系統才會執行其他動作。
- 日曆活動更新觸發條件會顯示新資訊卡或 使用者編輯並儲存日曆活動時的其他動作。
- 會顯示新資訊卡或接受 Drive onItemsSelected 觸發條件 使用者在雲端硬碟中選取一或多個檔案或資料夾時,執行的操作會受到限制。
- Gmail 撰寫觸發條件會在 使用者在 Gmail 撰寫視窗中開啟這個外掛程式。
- 顯示新資訊卡或擷取其他卡片的 Gmail 情境觸發條件 「動作」指標。
- Editor onFileScopeGranted 觸發條件,會在使用者時顯示新資訊卡
授予目前編輯器中
drive.file
OAuth 範圍的授權 文件。
在上表中,只有首頁觸發條件並非根據情境觸發。其餘的 內容觸發條件請參閱資訊清單 ,進一步瞭解資訊清單觸發條件的定義。
除了資訊清單觸發條件外,Google Workspace 外掛程式也可以使用 Apps Script 可安裝觸發條件。
限制
資訊清單觸發條件在使用上有一些限制。
- 這些觸發條件僅用於 Google Workspace 外掛程式專案。但這些應用程式對於任何其他應用方式並無關聯。
- 由於這些是在外掛程式資訊清單中定義,而不是在程式碼中,因此您無法
使用 Apps Script
Script
可用於建立或修改這些觸發條件的服務 - Gmail 內容相關觸發條件目前只能設定
unconditional
條件。 這表示無論如何 內容。 - 針對每位使用者,每個外掛程式的每種文件只能有一個觸發條件。