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