Package google.apps.script.type.gmail

索引

• ComposeTrigger (訊息)
• ComposeTrigger.DraftAccess (列舉)
• ContextualTrigger (訊息)
• GmailAddOnManifest (訊息)
• UnconditionalTrigger (訊息)
• UniversalAction (訊息)

ComposeTrigger

在使用者撰寫電子郵件時觸發的觸發條件。

欄位
actions[]	MenuItemExtensionPoint 定義組合時間外掛程式的一組動作。這些是使用者在撰寫時間外掛程式時可觸發的動作。
draftAccess	DraftAccess 定義觸發撰寫時間外掛程式時的資料存取權層級。

DraftAccess

列舉，定義 Compose 觸發事件所需的資料存取層級。

列舉
UNSPECIFIED	未設定草稿存取權時的預設值。
NONE	觸發 Compose 外掛程式時，撰寫觸發條件無法存取任何草稿資料。
METADATA	在觸發組合新增功能時，授予組合觸發事件存取草稿中繼資料的權限。包括目標對象名單，例如郵件草稿的收件者和副本清單。

ContextualTrigger

定義在開啟的電子郵件符合特定條件時觸發的觸發條件。觸發條件啟動時，會執行特定端點，以建立新資訊卡及更新 UI。

欄位
onTriggerFunction	string 必要欄位。訊息符合觸發條件時要呼叫的端點名稱。
聯集欄位 trigger。觸發事件類型會決定 Gmail 顯示外掛程式的條件。trigger 只能是下列其中一項：
unconditional	UnconditionalTrigger 無條件觸發事件會在開啟任何郵件時執行。

GmailAddOnManifest

屬性可自訂 Gmail 外掛程式的外觀和執行方式。

欄位
homepageTrigger	HomepageExtensionPoint 定義端點，在與已宣告的內容觸發事件不符的情況下執行。這個函式產生的任何資訊卡都會一律向使用者顯示，但如果這個外掛程式宣告了更多指定的觸發條件，資訊卡就可能會被情境內容遮蔽。 如有的話，這會覆寫 addOns.common.homepageTrigger 中的設定。
contextualTriggers[]	ContextualTrigger 定義觸發外掛程式的一組條件。
universalActions[]	UniversalAction 定義一組外掛程式的通用動作。使用者會透過外掛程式工具列選單觸發通用動作。
composeTrigger	ComposeTrigger 定義編寫時間外掛程式的編寫時間觸發條件。這個觸發條件會在使用者撰寫電子郵件時，讓外掛程式採取行動。所有撰寫時間外掛程式都必須具備 gmail.addons.current.action.compose 範圍，即使不能編輯草稿也一樣。
authorizationCheckFunction	string 這個端點會透過探測第三方 API，驗證外掛程式是否具備所有必要的第三方授權。如果探測失敗，函式應擲回例外狀況，以啟動授權流程。這個函式會在每次叫用外掛程式前呼叫，以確保使用者體驗流暢。

UnconditionalTrigger

這個類型沒有任何欄位。

當任何電子郵件訊息開啟時觸發的觸發條件。

UniversalAction

無論郵件內容為何，這個動作一律會顯示在外掛程式工具列選單中。

欄位
text	string 必要欄位。使用者看到的動作說明文字，例如「新增聯絡人」。
聯集欄位 action_type。動作類型會決定使用者叫用動作時的 Gmail 行為。action_type 只能是下列其中一項：
openLink	string 使用者觸發動作時，Gmail 會開啟的連結。
runFunction	string 使用者觸發動作時呼叫的端點。詳情請參閱通用動作指南。