Package google.apps.script.type.gmail

Index

ComposeTrigger

Ein Trigger, der aktiviert wird, wenn ein Nutzer eine E-Mail verfasst.

Felder
actions[]

MenuItemExtensionPoint

Definiert die Aktionen für ein Erstellungszeit-Add-on. Das sind Aktionen, die Nutzer für ein Add-on für die Erstellungszeit auslösen können.

draftAccess

DraftAccess

Definiert die Ebene des Datenzugriffs, wenn ein Erstellungszeit-Add-on ausgelöst wird.

DraftAccess

Ein Enum-Wert, der die Ebene des Datenzugriffs definiert, die der Erstellungsauslöser erfordert.

Enums
UNSPECIFIED Standardwert, wenn für „DraftAccess“ nichts festgelegt ist.
NONE Wenn ein Editor-Add-on ausgelöst wird, hat der Trigger zum Schreiben keinen Zugriff auf Daten des Entwurfs.
METADATA Gewährt dem Trigger zum Verfassen der Nachricht die Berechtigung, auf die Metadaten des Entwurfs zuzugreifen, wenn ein Editor-Add-on ausgelöst wird. Dazu gehört auch die Zielgruppenliste, z. B. die Empfänger- und Cc-Listen eines Nachrichtenentwurfs.

ContextualTrigger

Definiert einen Trigger, der ausgelöst wird, wenn die geöffnete E-Mail ein bestimmtes Kriterium erfüllt. Wenn der Trigger ausgelöst wird, führt er einen bestimmten Endpunkt aus, normalerweise um neue Karten zu erstellen und die UI zu aktualisieren.

Felder
onTriggerFunction

string

Erforderlich. Der Name des Endpunkts, der aufgerufen werden soll, wenn eine Nachricht mit dem Trigger übereinstimmt.

Union-Feld trigger. Der Typ des Triggers bestimmt, welche Bedingungen Gmail verwendet, um das Add-on anzuzeigen. Für trigger ist nur einer der folgenden Werte zulässig:
unconditional

UnconditionalTrigger

Bedingungslose Trigger werden ausgeführt, wenn eine E-Mail-Nachricht geöffnet wird.

GmailAddOnManifest

Eigenschaften, mit denen das Aussehen und die Ausführung eines Gmail-Add-ons angepasst werden kann.

Felder
homepageTrigger

HomepageExtensionPoint

Definiert einen Endpunkt, der in Kontexten ausgeführt wird, die keinem deklarierten Kontexttrigger entsprechen. Alle von dieser Funktion generierten Karten sind für den Nutzer immer verfügbar, werden aber möglicherweise durch kontextbezogene Inhalte überlagert, wenn über dieses Add-on gezieltere Trigger deklariert werden.

Falls vorhanden, wird damit die Konfiguration aus addOns.common.homepageTrigger überschrieben.

contextualTriggers[]

ContextualTrigger

Definiert die Bedingungen, die das Add-on auslösen.

universalActions[]

UniversalAction

Definiert eine Reihe universeller Aktionen für das Add-on. Der Nutzer löst über das Symbolleistenmenü des Add-ons universelle Aktionen aus.

composeTrigger

ComposeTrigger

Definiert den Erstellungszeit-Trigger für ein Erstellungszeit-Add-on. Dies ist der Trigger, durch den ein Add-on beim Schreiben einer E-Mail ausgeführt wird. Alle Add-ons für die Erstellungszeit müssen den Geltungsbereich gmail.addons.current.action.compose haben, auch wenn der Entwurf dadurch möglicherweise nicht bearbeitet wird.

authorizationCheckFunction

string

Der Name eines Endpunkts, der durch Prüfen der Drittanbieter-APIs überprüft, ob das Add-on alle erforderlichen Drittanbieterautorisierungen hat. Wenn die Prüfung fehlschlägt, sollte die Funktion eine Ausnahme auslösen, um den Autorisierungsvorgang zu starten. Diese Funktion wird vor jedem Aufruf des Add-ons aufgerufen, um eine reibungslose Nutzererfahrung zu gewährleisten.

UnconditionalTrigger

Dieser Typ hat keine Felder.

Ein Trigger, der ausgelöst wird, wenn eine E-Mail-Nachricht geöffnet wird.

UniversalAction

Eine Aktion, die unabhängig vom Nachrichtenkontext immer im Add-on-Symbolleistenmenü verfügbar ist.

Felder
text

string

Erforderlich. Für den Nutzer sichtbarer Text, der die Aktion beschreibt, z. B. „Neuen Kontakt hinzufügen“.

Union-Feld action_type. Der Typ der Aktion bestimmt das Verhalten von Gmail, wenn der Nutzer die Aktion aufruft. Für action_type ist nur einer der folgenden Werte zulässig:
runFunction

string

Ein Endpunkt, der aufgerufen wird, wenn der Nutzer die Aktion auslöst. Weitere Informationen finden Sie im Leitfaden zu universellen Aktionen.