Editor-Manifestressource

Die Ressourcenkonfiguration, mit der Google Workspace-Add‑on Inhalte und ‑Verhaltensweisen in den Editoren definiert werden. Google Workspace-Add‑on-Manifeste müssen alle als Erforderlich gekennzeichneten Komponenten enthalten, wenn sie den Editor erweitern.

Editoren

Die Google Workspace-Add‑on-Manifestkonfiguration für Editorerweiterungen. Weitere Informationen finden Sie unter Editoren mit Google Workspace-Add‑ons erweitern.

JSON-Darstellung 
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
Felder
homepageTrigger

object (HomepageTrigger)

Diese Triggerfunktion erstellt die Add‑on Startseite in der Host-App. Dadurch wird addOns.common.homepageTrigger überschrieben.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Erforderlich, wenn das Add‑on ein Verhalten enthält , das für das aktuelle Dokument spezifisch ist. Wird ausgelöst, wenn der Nutzer den Bereich drive.file autorisiert.
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Erforderlich für Linkvorschauen. Eine Liste von Triggern für die Vorschau von Links in einer Google Docs-, Google Sheets- oder Google Präsentationen-Datei. Weitere Informationen finden Sie unter Vorschau von Links mit Smartchips.

createActionTriggers[]

object (createActionTriggers)

Erforderlich für die Erstellung von Ressourcen von Drittanbietern. Eine Liste von Triggern zum Erstellen von Ressourcen in einem Drittanbieterdienst über das @-Menü. Weitere Informationen finden Sie unter Ressourcen von Drittanbietern mit Smartchips erstellen.

OnFileScopeGrantedTrigger

Eine Konfiguration für einen kontextbezogenen Trigger, der ausgelöst wird, wenn im Dialogfeld für den Dateibereich der Anfrage CardService.newEditorFileScopeActionResponseBuilder().requestFileScopeForActiveDocument().build(); verwendet wird und der Nutzer die Autorisierung für den Bereich drive.file erteilt.

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

string

Der Name der Funktion, die ausgeführt werden soll, wenn der Bereich drive.file gewährt wird. Die Funktion muss ein Array von Card Objekten für die Benutzeroberfläche zurückgeben.

LinkPreviewTriggers

Die Konfiguration für einen Trigger, der ausgelöst wird, wenn ein Nutzer einen Link von einem Drittanbieterdienst in eine Google Docs-, Google Sheets- oder Google Präsentationen-Datei eingibt oder einfügt.

Informationen zum Einrichten dieses Triggers für ein Google Workspace-Add‑on finden Sie unter Vorschau von Links mit Smartchips.

JSON-Darstellung 
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
Felder
labelText

string

Erforderlich. Der Text für einen Smartchip, der Nutzer auffordert, eine Vorschau des Links aufzurufen, z. B. Example: Support case. Dieser Text ist statisch.
localizedLabelText

map (key: string, value: string)

Optional. Eine Zuordnung von labelText zur Lokalisierung in andere Sprachen. Formatieren Sie die Sprache in ISO 639 und das Land/die Region in ISO 3166, getrennt durch einen Bindestrich -.
patterns[]

object (UriPattern)

Erforderlich. Ein Array von URL-Mustern, die das Add‑on auslösen, um eine Vorschau von Links aufzurufen.
runFunction

string

Erforderlich. Der Name der Funktion, die ausgeführt werden soll, wenn der Nutzer den https://www.googleapis.com/auth/workspace.linkpreview Bereich autorisiert. Die Funktion muss ein Ereignisobjekt akzeptieren, das eine matchedUrl.url Eigenschaft mit der URL enthält, für die eine Vorschau aufgerufen werden soll, und ein Card Objekt zurückgeben.
logoUrl

string

Optional. Das Symbol, das im Smartchip und auf der Vorschaukarte angezeigt wird. Wenn es nicht angegeben ist, verwendet das Add‑on sein Symbol in der Symbolleiste, logoUrl.

UriPattern

Die Konfiguration für jedes URL-Muster, das eine Linkvorschau auslöst.

JSON-Darstellung 
{
  "hostPattern": string,
  "pathPrefix" : string
}
Felder
hostPattern

string

Für jedes URL-Muster erforderlich. Die Domain des URL-Musters. Das Add‑on ruft eine Vorschau von Links auf, die diese Domain enthalten. Verwenden Sie einen Platzhalterstern (*), um alle Subdomains abzugleichen.
pathPrefix

string

Optional. Der Pfad, der an die Domain angehängt wird. Lassen Sie pathPrefix leer, um alle URLs in der Domain abzugleichen.

CreateActionTriggers

Die Konfiguration für einen Trigger, der ausgelöst wird, wenn ein Nutzer ein Menüelement für die Integration eines Drittanbieters im @-Menü von Google Docs auswählt.

Informationen zum Einrichten dieses Triggers für ein Google Workspace-Add‑on finden Sie unter Ressourcen von Drittanbietern mit Smartchips erstellen.

JSON-Darstellung 
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
Felder
id

string

Erforderlich. Die eindeutige ID für diesen Erweiterungspunkt. Verwenden Sie bis zu 64 Zeichen im [a-zA-Z0-9-]+. Format.
labelText

string

Erforderlich. Der Text, der im @-Menü angezeigt wird, z. B. Create support case.
localizedLabelText

map (key: string, value: string)

Optional. Eine Zuordnung von labelText zur Lokalisierung. Formatieren Sie die Sprache im Format ISO 639 und das Land/die Region im Format ISO 3166, getrennt durch einen Bindestrich -.
runFunction

string

Erforderlich. Der Name der Funktion, die ausgeführt werden soll, wenn ein Nutzer einen Erweiterungspunkt auswählt. Die Funktion muss eine Formularkarte zurückgeben.
logoUrl

string

Optional. Das Symbol, das im @-Menü angezeigt wird. Wenn es nicht angegeben ist, verwendet das Add‑on sein Symbol in der Symbolleiste, logoUrl.