Gmail-Manifest-Ressource

Die Ressourcenkonfiguration, mit der der Inhalt und das Verhalten eines Google Workspace-Add-ons in Gmail definiert wird. In Manifesten von 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 die Anforderungen an die Autorisierung von Drittanbietern prüft. Diese Funktion wird vor jedem Aufruf des Google Workspace-Add-ons aufgerufen.

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

composeTrigger

object (ComposeTrigger)

Erforderlich für Aktionen zum Erstellen. Definiert die Benutzeroberflächen, die dem Nutzer beim Verfassen einer E-Mail zur Verfügung stehen.

Weitere Informationen finden Sie unter Benutzeroberfläche für das Verfassen von E-Mails mit Aktionen zum Verfassen 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, wird eine bestimmte Apps Script-Funktion ausgeführt, in der Regel zum Erstellen neuer Karten und Aktualisieren der Benutzeroberfläche.
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 Compose-Aktion. Weitere Informationen finden Sie unter Compose-Benutzeroberfläche erweitern.

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

string

Definiert die Datenzugriffsebene, die für eine Funktion des Zusammenstellungstriggers verfügbar ist. Gültige Optionen sind:

  • NONE (Standardeinstellung) Das Ereignisobjekt, das an die Funktion „compose trigger“ übergeben wird, ist dann größtenteils leer.
  • METADATA, das das Ereignisobjekt, das an die Triggerfunktion zum Verfassen übergeben wird, mit Listen der Empfänger der Nachricht füllt. 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 Bedienoberflächen zum Erstellen von Inhalten. Diese Liste ist jedoch auf eine Aktion pro Add-on beschränkt. Die Aktion „Schreiben“ hat ein entsprechendes Symbol im Gmail-Fenster „Neue Nachricht“. Das Symbol wird durch gmail.logoUrl angegeben.

ContextualTrigger

Die Konfiguration eines Triggers, 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 Funktion für kontextbezogenen Trigger.

unconditional

object

Erforderlich für jeden kontextbezogenen Trigger. Hiermit 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 dies immer ein leeres Objekt sein.

SelectAction

Die Konfiguration der Aktion „Schreiben“, die festlegt, welche Funktion ausgeführt werden soll, wenn der Nutzer die Aktion „Schreiben“ auswählt.

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

string

Erforderlich für Aktionen zum Erstellen. Der Name der Apps Script-Funktion, die ausgeführt wird, wenn diese Aktion zum Verfassen ausgewählt wird. Mit dieser Funktion wird die Benutzeroberfläche für das Erstellen von Add-ons erstellt.

Weitere Informationen finden Sie unter Triggerfunktion erstellen.

text

string

Erforderlich für Aktionen zum Erstellen. Eine kurze Textbeschreibung dieser Aktion.