AddOns-Manifestressource

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

AddOns

Die Konfiguration der obersten Ebene des Google Workspace-Add‑on-Manifests.

JSON-Darstellung
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "chat": {
    object (Chat)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
Felder
common

object (Common)

Erforderlich. Definiert Werte für ein Google Workspace-Add‑on, die für jede Hostanwendung gleich sind. Einige der hier definierten Werte werden als Standard verwendet, wenn bestimmte Werte für einen bestimmten Host fehlen.

calendar

object (Calendar)

Erforderlich, wenn das Google Workspace-Add‑on Calendar erweitert. Konfigurationen für das Erscheinungsbild und das Verhalten von Google Workspace-Add‑ons in der Hostanwendung Google Kalender. Wenn dieses Feld weggelassen wird, ist das Add‑on in Google Kalender deaktiviert.

chat

object ()

Erforderlich, wenn das Google Workspace-Add‑on Chat erweitert. Konfiguration einer Google Chat-App. Wenn dieses Feld weggelassen wird, ist das Add‑on in Google Chat deaktiviert.

Das addOns.chat-Objekt muss leer sein. Informationen zum Konfigurieren des Verhaltens und der Darstellung des Add‑ons in Chat finden Sie unter Chat-App konfigurieren.

drive

object (Drive)

Erforderlich, wenn das Google Workspace-Add‑on Google Drive erweitert. Konfigurationen für das Erscheinungsbild und Verhalten von Google Workspace-Add-ons in der Google Drive-Hostanwendung. Wenn dieses Feld weggelassen wird, ist das Add-on in Google Drive deaktiviert.

gmail

object (Gmail)

Erforderlich, wenn das Google Workspace-Add-on Gmail erweitert. Konfigurationen für das Erscheinungsbild und das Verhalten von Google Workspace-Add-ons in der Gmail-Hostanwendung. Wenn dieses Feld weggelassen wird, ist das Add-on in Gmail deaktiviert.

docs

object (Docs)

Erforderlich, wenn das Google Workspace-Add‑on Docs erweitert. Konfigurationen für das Erscheinungsbild und das Verhalten des Google Workspace-Add‑ons in der Docs-Hostanwendung. Wenn dieses Feld weggelassen wird, ist das Add-on in Google Docs deaktiviert.

sheets

object (Sheets)

Erforderlich, wenn das Google Workspace-Add‑on Sheets erweitert. Konfigurationen für das Erscheinungsbild und Verhalten des Google Workspace-Add-ons in der Sheets-Hostanwendung. Wenn dieses Feld weggelassen wird, ist das Add-on in Google Tabellen deaktiviert.

slides

object (Slides)

Erforderlich, wenn das Google Workspace-Add‑on Google-Präsentationen erweitert. Konfigurationen für das Erscheinungsbild und Verhalten des Google Workspace-Add‑ons in der Hostanwendung für Präsentationen. Wenn dieses Feld weggelassen wird, ist das Add-on in Google Präsentationen deaktiviert.

Verbreitet

Die Manifestkonfiguration für Parameter, die für jede Hostanwendung gelten. Einige der hier definierten Werte werden als Standard verwendet, wenn bestimmte Werte für einen bestimmten Host weggelassen werden.

JSON-Darstellung
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
Felder
homepageTrigger

object (HomepageTrigger)

Die Standardspezifikation für die Triggerfunktion zum Erstellen der Startseite des Add-ons. Diese Spezifikation wird verwendet, wenn kein hostspezifischer Startseitentrigger definiert ist. Wenn auch diese nicht angegeben wird, wird bei Bedarf eine allgemeine Startseitenkarte erstellt und verwendet.
layoutProperties

object (LayoutProperties)

Eine Konfiguration für die Farben, die in der Add-on-Symbolleiste und den Schaltflächen verwendet werden.
logoUrl

string

Erforderlich. Die URL des Bildes, das in der Symbolleiste angezeigt wird. Die URL muss öffentlich sein.

name

string

Erforderlich. Der Name des Add-ons, der in der Symbolleiste angezeigt wird.

openLinkUrlPrefixes[]

string

Erforderlich, wenn im Add-on ausgehende Links angezeigt werden, entweder in Widgets mit einem OpenLink oder in Text-Widgets mit HTML-Anchor-Tags. Eine Liste mit HTTPS-URL-Präfixen. Zum Schutz von Nutzerdaten muss jeder vom Add-on gerenderte Link mit einem der Präfixe in dieser Liste übereinstimmen.

Weitere Informationen finden Sie unter URLs auf die Zulassungsliste setzen.

universalActions[]

object (UniversalAction)

Liste der universellen Aktionen, die immer in der Add-on-Benutzeroberfläche verfügbar sind.
useLocaleFromApp

boolean

Wenn true, enthalten Add-on- Ereignisobjekte, die an Aktions-Callback-Funktionen oder Triggerfunktionen übergeben werden, die Informationen zur Spracheinstellung und Zeitzone des Nutzers. Die Standardeinstellung ist false.

Weitere Informationen finden Sie unter Auf Nutzer-Locale und Zeitzonen zugreifen.

LayoutProperties

Eine Konfiguration, mit der die Farben und das Erscheinungsbild der Google Workspace-Add-on-Symbolleiste und -Schaltflächen gesteuert werden.

JSON-Darstellung
{
  "primaryColor": string,
  "secondaryColor": string
}
Felder
primaryColor

string

Die Farbe der Symbolleiste. Die Standardeinstellung ist Grau (#424242).
secondaryColor

string

Die Standardfarbe von Schaltflächen. Standardmäßig wird die Primärfarbe verwendet (falls sie festgelegt ist). Andernfalls wird standardmäßig Blau (#2196F3) verwendet.

UniversalAction

Eine Konfiguration für eine universelle Aktion. Wenn diese Option ausgewählt ist, wird entweder der angegebene URL-Link geöffnet oder die angegebene Apps Script-Funktion ausgeführt.

JSON-Darstellung
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
Felder
label

string

Für jede universelle Aktion erforderlich. Der Text, der im UI-Menü für diese Aktion angezeigt wird.
runFunction

string

Erforderlich für jede universelle Aktion, wenn openLink nicht vorhanden ist. Falls angegeben, der Name der Apps Script-Funktion, die ausgeführt wird, wenn der Nutzer diese Aktion auswählt.

Weitere Informationen finden Sie im Leitfaden Universelle Aktionen.