Gmail-Manifest-Ressource

Die Ressourcenkonfiguration, die zum Definieren von Inhalten und Verhalten von Google Workspace-Add-ons in Gmail verwendet wird. Google Workspace-Add‑on-Manifeste müssen alle Komponenten enthalten, die als Erforderlich gekennzeichnet sind, wenn sie Gmail erweitern.

sollten Sie vorhandene Add-ons auf Add-ons aktualisieren.

Gmail

Die Google Workspace-Add-on-Manifestkonfiguration für Gmail-Erweiterungen. Weitere Informationen finden Sie unter Gmail mit Google Workspace-Add-ons erweitern.

JSON-Darstellung 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Felder
authorizationCheckFunction

string

Veraltet. Der Name einer Apps Script-Funktion, die Autorisierungsprüfungen von Drittanbietern durchführt.

Diese Funktion wurde verworfen. Stattdessen sollte das Add‑on eine Ausnahme vom Hauptaufruf auslösen, wie im Beispiel für die OAuth-Konfiguration für Nicht-Google-Konten gezeigt.

composeTrigger

object (ComposeTrigger)

Für Compose-Aktionen erforderlich. Definiert die Benutzeroberflächen, die beim Verfassen einer E‑Mail verfügbar sind.

Weitere Informationen finden Sie unter Compose-Benutzeroberfläche mit Compose-Aktionen erweitern.

contextualTriggers[]

object (ContextualTrigger)

Erforderlich. Eine Liste der Trigger, die ausgelöst werden, wenn eine Nachricht in Gmail geöffnet wird. Mit Triggern wird eine bestimmte Apps Script-Funktion ausgeführt, um die Benutzeroberfläche zu aktualisieren.
homepageTrigger

object (HomepageTrigger)

Die Triggerfunktion für das Add-on homepage in Gmail. Dadurch wird addOns.common.homepageTrigger überschrieben.

ComposeTrigger

Die Konfiguration für eine Compose-Aktion. Weitere Informationen finden Sie unter Compose-Benutzeroberfläche erweitern.

JSON-Darstellung 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Felder
draftAccess

string

Definiert die Datenzugriffsebene für eine Compose-Triggerfunktion. Gültige Optionen sind:

  • NONE (Standard): Das Ereignisobjekt ist größtenteils leer.
  • METADATA: Das Ereignisobjekt enthält Empfängerlisten. Dazu ist der gmail.addons.current.message.metadata-Bereich erforderlich.
selectActions[]

object (SelectAction)

Eine Liste mit Compose-Aktionen. Die Liste ist auf eine einzelne Aktion pro Add-on beschränkt. Die Aktion „Schreiben“ hat ein Symbol im Gmail-Fenster, das durch gmail.logoUrl angegeben wird.

ContextualTrigger

Die Konfiguration für einen Trigger, der ausgelöst wird, wenn ein Nutzer eine Gmail-Nachricht öffnet. Weitere Informationen finden Sie unter Nachrichten-UI erweitern.

JSON-Darstellung 
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Felder
onTriggerFunction

string

Erforderlich für jeden kontextbezogenen Trigger. Der Name der Apps Script-Funktion, die ausgeführt wird, wenn der Trigger ausgelöst wird.
unconditional

object

Erforderlich für jeden kontextbezogenen Trigger. Gibt an, dass der Trigger für alle geöffneten Gmail-Nachrichten aktiviert wird. Dies sollte immer ein leeres Objekt sein.

SelectAction

Die Konfiguration der Compose-Aktion, die die Funktion definiert, die bei Auswahl ausgeführt werden soll.

JSON-Darstellung 
{
  "runFunction": string,
  "text": string
}
Felder
runFunction

string

Für Compose-Aktionen erforderlich. Der Name der Apps Script-Funktion, die bei Auswahl ausgeführt wird. Die Funktion erstellt die Compose-Benutzeroberfläche des Add-ons.
text

string

Für Compose-Aktionen erforderlich. Eine kurze Beschreibung der Aktion.