Package google.apps.script.type.gmail

Index

ComposeTrigger

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

Felder
actions[]

MenuItemExtensionPoint

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

draftAccess

DraftAccess

Hiermit wird die Datenzugriffsebene definiert, wenn ein Add-on zur Erstellungszeit ausgelöst wird.

DraftAccess

Ein Enum, das die Datenzugriffsebene definiert, die für den Zusammenstellungstrigger erforderlich ist.

Enums
UNSPECIFIED Standardwert, wenn für „draftAccess“ nichts festgelegt ist.
NONE Der Trigger „Schreiben“ kann nicht auf Daten des Entwurfs zugreifen, wenn das entsprechende Add-on ausgelöst wird.
METADATA Gewährt dem Erstellungs-Trigger die Berechtigung, auf die Metadaten des Entwurfs zuzugreifen, wenn ein Editor-Add-on ausgelöst wird. Das gilt auch für die Zielgruppenliste, z. B. für die Empfänger- und Cc-Listen in einem Nachrichtenentwurf.

ContextualTrigger

Hiermit wird ein Trigger definiert, der ausgelöst wird, wenn die geöffnete E-Mail bestimmte Kriterien 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 Triggertyp bestimmt die Bedingungen, unter denen das Add-on in Gmail angezeigt wird. 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 zum Anpassen der Darstellung und Ausführung eines Gmail-Add-ons.

Felder
homepageTrigger

HomepageExtensionPoint

Hiermit wird ein Endpunkt definiert, der in Kontexten ausgeführt wird, die nicht mit einem deklarierten kontextbezogenen Trigger übereinstimmen. Alle Karten, die mit dieser Funktion generiert werden, sind für den Nutzer immer verfügbar, können aber von kontextbezogenen Inhalten verdeckt werden, wenn dieses Add-on gezieltere Trigger deklariert.

Falls vorhanden, wird 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 universelle Aktionen über das Menü der Add-on-Symbolleiste aus.

composeTrigger

ComposeTrigger

Definiert den Trigger für die Erstellungszeit für ein Add-on für die Erstellungszeit. Dieser Trigger bewirkt, dass ein Add-on eine Aktion ausführt, wenn der Nutzer eine E-Mail verfasst. Alle Add-ons zur Erstellungszeit müssen den Bereich gmail.addons.current.action.compose haben, auch wenn der Entwurf dadurch möglicherweise nicht bearbeitet wird.

authorizationCheckFunction

string

Der Name eines Endpunkts, mit dem durch Prüfen der Drittanbieter-APIs bestätigt wird, dass das Add-on alle erforderlichen Drittanbieterautorisierungen hat. Wenn die Prüfung fehlschlägt, sollte die Funktion eine Ausnahme auslösen, um den Autorisierungsvorgang zu initiieren. Diese Funktion wird vor jedem Aufruf des Add-ons aufgerufen, um eine reibungslose Nutzung 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 Menü der Add-on-Symbolleiste verfügbar ist.

Felder
text

string

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

Union-Feld action_type. Der Aktionstyp bestimmt das Verhalten von Gmail, wenn der Nutzer die Aktion auslöst. 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 für universelle Aktionen.