Google Workspace 外掛程式觸發條件

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 條件。 這表示無論如何 內容。
• 針對每位使用者，每個外掛程式的每種文件只能有一個觸發條件。