Gmail-Manifest-Ressource

Die Ressourcenkonfiguration, mit der 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

Die 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 durch Drittanbieter prüft. Diese Funktion wird vor jedem Aufruf des Google Workspace-Add-ons aufgerufen.

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

composeTrigger

object (ComposeTrigger)

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

Weitere Informationen finden Sie unter UI zum Schreiben mit Eingabeaktionen erweitern.

contextualTriggers[]

object (ContextualTrigger)

Erforderlich. Eine Liste von Triggern, 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, in der Regel zum Erstellen neuer Karten und zum Aktualisieren der UI.
homepageTrigger

object (HomepageTrigger)

Die Triggerfunktionsspezifikation zum Erstellen der Add-on-Startseite auf dem Gmail-Host. Dadurch wird addOns.common.homepageTrigger überschrieben.

ComposeTrigger

Die Konfiguration für eine Schreibaktion. Weitere Informationen finden Sie unter Compose-UI erweitern.

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

string

Definiert die Zugriffsebene des Datenzugriffs, die einer Erstellungs-Triggerfunktion zur Verfügung steht. Gültige Optionen sind:

  • NONE ist die Standardeinstellung. Dadurch ist das an die Triggerfunktion zur Zusammensetzung übergebene Ereignisobjekt weitgehend leer.
  • METADATA: Damit wird das Ereignisobjekt, das an die Triggerfunktion zum Erstellen einer Nachricht übergeben wird, mit Listen der Empfänger der Nachricht ausgefüllt. Für diese Einstellung muss das Add-on den Bereich gmail.addons.current.message.metadata enthalten.
selectActions[]

object (SelectAction)

Eine Liste von Erstellungsaktionen, mit denen Erstellungs-UIs erstellt werden. Diese Liste ist jedoch auf eine Aktion pro Add-on beschränkt. Beim Schreiben wird im Gmail-Fenster „Schreiben“ 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

Für jeden kontextbezogenen Trigger erforderlich. Der Name der Apps Script-Funktion, die bei Auslösung des Triggers ausgeführt wird.

Weitere Informationen zum Definieren dieser Funktion finden Sie unter Kontextabhängige Triggerfunktion.

unconditional

object

Für jeden kontextbezogenen Trigger erforderlich. Wird verwendet, um anzugeben, dass der kontextbezogene Trigger für alle Gmail-Nachrichten aktiviert wird, wenn sie geöffnet werden. Da dies derzeit die einzige Option ist, sollte es immer ein leeres Objekt sein.

SelectAction

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

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

string

Erforderlich beim Schreiben. Der Name der Apps Script-Funktion, die ausgeführt wird, wenn diese Erstellungsaktion ausgewählt wird. Mit dieser Triggerfunktion zum Erstellen wird die UI zum Schreiben von Add-ons erstellt.

Weitere Informationen finden Sie unter Triggerfunktion erstellen.

text

string

Erforderlich beim Schreiben. Eine kurze Beschreibung dieser Schreibaktion.