Gmail-Manifest-Ressource

Die Ressourcenkonfiguration, mit der die Inhalte und das Verhalten des Google Workspace-Add-ons in Gmail definiert werden. In den Manifesten des Google Workspace-Add-ons müssen alle Komponenten als Erforderlich gekennzeichnet sein, wenn sie Gmail erweitern.

Gmail

Manifestkonfiguration des Google Workspace-Add-ons 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 Autorisierungsanforderungen von Drittanbietern prüft. Diese Funktion wird vor jedem Aufruf des Google Workspace-Add-ons aufgerufen.

Diese Funktion wurde verworfen, um unnötige Ausführungslatenz zu vermeiden. Stattdessen sollte das Add-on eine Ausnahme vom Hauptaufruf auslösen, wie in diesem Beispiel gezeigt.

composeTrigger

object (ComposeTrigger)

Erforderlich für Erstellungsaktionen. Definiert die Benutzeroberflächen, die dem Nutzer beim Schreiben einer E-Mail zur Verfügung stehen.

Weitere Informationen finden Sie unter Benutzeroberfläche zum Schreiben einer Nachricht durch Aktionen zum Schreiben erweitern.

contextualTriggers[]

object (ContextualTrigger)

Erforderlich. Eine Liste der Trigger, die ausgelöst werden, wenn eine Nachricht in Gmail geöffnet wird. Wenn der Trigger ausgelöst wird, führt er eine bestimmte Apps Script-Funktion aus, normalerweise um neue Karten zu erstellen und die UI zu aktualisieren.
homepageTrigger

object (HomepageTrigger)

Die Triggerfunktionsspezifikation zum Erstellen der Startseite des Add-ons im Gmail-Host. Dadurch wird addOns.common.homepageTrigger überschrieben.

ComposeTrigger

Die Konfiguration für eine Erstellungsaktion. Weitere Informationen finden Sie unter Benutzeroberfläche zum Schreiben einer Nachricht erweitern.

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

string

Definiert die Ebene des Datenzugriffs, die einer Funktion zum Zusammensetzen von Triggern zur Verfügung steht. Gültige Optionen sind:

  • NONE, die Standardeinstellung. Dadurch ist das Ereignisobjekt, das an die Funktion zum Zusammensetzen des Triggers übergeben wird, fast leer.
  • METADATA, über die das an die Triggerfunktion „Zusammensetzung“ übergebene Ereignisobjekt mit Listen der Empfänger der Nachricht gefüllt wird. Für diese Einstellung muss das Add-on den Bereich gmail.addons.current.message.metadata enthalten.
selectActions[]

object (SelectAction)

Eine Liste von Aktionen zum Erstellen von Erstellungs-UIs. Diese Liste ist jedoch auf eine einzige Aktion pro Add-on beschränkt. Für die Aktion "Schreiben" wird im Editorfenster von Gmail ein entsprechendes Symbol angezeigt. Das Symbol wird durch gmail.logoUrl angegeben.

ContextualTrigger

Die Konfiguration für einen Trigger, der ausgelöst wird, wenn der Nutzer eine Gmail-Nachricht öffnet und diese Nachricht bestimmte Kriterien erfüllt. 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.

Weitere Informationen zum Definieren dieser Funktion finden Sie unter Kontextbezogene Triggerfunktion.

unconditional

object

Erforderlich für jeden kontextbezogenen Trigger. Damit wird angegeben, dass der kontextbezogene Trigger für alle Gmail-Nachrichten aktiviert wird, wenn sie geöffnet werden. Dies ist derzeit die einzige Option, daher sollte es immer ein leeres Objekt sein.

SelectAction

Die Konfiguration der Erstellungsaktion, die definiert, welche Funktion ausgeführt werden soll, wenn der Nutzer die Erstellungsaktion auswählt.

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

string

Erforderlich für Erstellungsaktionen. Der Name der Apps Script-Funktion, die ausgeführt wird, wenn diese Erstellungsaktion ausgewählt wird. Mit dieser Funktion wird die Add-on-Benutzeroberfläche zum Schreiben erstellt.

Weitere Informationen finden Sie unter Triggerfunktion erstellen.

text

string

Erforderlich für Erstellungsaktionen. Eine kurze Textbeschreibung dieser Erstellungsaktion.