Got 5 mins? Help us improve Add-ons documentation by taking a quick online study.

Package google.apps.script.type.gmail

Index

ComposeTrigger

A trigger that activates when user is composing an email.

Fields
actions[]

MenuItemExtensionPoint

Defines the set of actions for a compose time add-on. These are actions that users can trigger on a compose time add-on.

draftAccess

DraftAccess

Defines the level of data access when a compose time add-on is triggered.

DraftAccess

An enum that defines the level of data access the compose trigger requires.

Enums
UNSPECIFIED Default value when nothing is set for draftAccess.
NONE The compose trigger can't access any data of the draft when a compose add-on is triggered.
METADATA Gives the compose trigger the permission to access the metadata of the draft when a compose add-on is triggered. This includes the audience list, such as the To and Cc list of a draft message.

ContextualTrigger

Defines a trigger that fires when the open email meets a specific criteria. When the trigger fires, it executes a specific endpoint, usually in order to create new cards and update the UI.

Fields
onTriggerFunction

string

Required. The name of the endpoint to call when a message matches the trigger.

unconditional

UnconditionalTrigger

Unconditional triggers are executed when any mail message is opened.

GmailAddOnManifest

Properties customizing the appearance and execution of a Gmail add-on.

Fields
homepageTrigger

HomepageExtensionPoint

Defines an endpoint that will be executed in contexts that don't match a declared contextual trigger. Any cards generated by this function will always be available to the user, but may be eclipsed by contextual content when this add-on declares more targeted triggers.

If present, this overrides the configuration from addOns.common.homepageTrigger.

contextualTriggers[]

ContextualTrigger

Defines the set of conditions that trigger the add-on.

universalActions[]

UniversalAction

Defines a set of universal actions for the add-on. The user triggers universal actions from the add-on toolbar menu.

composeTrigger

ComposeTrigger

Defines the compose time trigger for a compose time add-on. This is the trigger that causes an add-on to take action when the user is composing an email. All compose time add-ons must have the gmail.addons.current.action.compose scope even though it might not edit the draft.

authorizationCheckFunction

string

The name of an endpoint that verifies that the add-on has all the required third-party authorizations, by probing the third-party APIs. If the probe fails, the function should throw an exception to initiate the authorization flow. This function is called before each invocation of the add-on in order to ensure a smooth user experience.

UnconditionalTrigger

A trigger that fires when any email message is opened.

UniversalAction

An action that is always available in the add-on toolbar menu regardless of message context.

Fields
text

string

Required. User-visible text describing the action, for example, "Add a new contact."

Union field action_type. The type of the action determines the behavior of Gmail when the user invokes the action. action_type can be only one of the following:
runFunction

string

An endpoint that is called when the user triggers the action. See the universal actions guide for details.