Package google.apps.script.type.gmail

索引

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

ComposeTrigger

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

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

DraftAccess

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

列舉
UNSPECIFIED	未設定草稿存取權時的預設值。
NONE	觸發 Compose 外掛程式時，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 使用者觸發動作時呼叫的端點。詳情請參閱通用動作指南。