Diese Seite wurde von der Cloud Translation API übersetzt.

Editor-Manifestressource

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

Bearbeiter

Die Manifestkonfiguration des Google Workspace-Add-ons für Editor-Erweiterungen. Weitere Informationen finden Sie unter Editors mit Google Workspace-Add-ons erweitern.

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

JSON-Darstellung

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

Felder
`homepageTrigger`	`object (HomepageTrigger)` Diese Triggerfunktion erstellt die Startseite des Add-ons in der Host-App. Dadurch wird `addOns.common.homepageTrigger` überschrieben.
`onFileScopeGrantedTrigger`	`object (OnFileScopeGrantedTrigger)` Erforderlich, wenn das Add-on ein Verhalten aufweist, das für das aktuelle Editor-Dokument spezifisch ist. Es wird ausgelöst, wenn der Nutzer den Bereich `drive.file` autorisiert.
`linkPreviewTriggers[]`	`object (LinkPreviewTriggers)` Erforderlich für Linkvorschauen. Eine Liste der Trigger für die Vorschau von Links in einer Google Docs-, Google Tabellen- oder Google Präsentationen-Datei. Weitere Informationen finden Sie unter Vorschaulinks mit Smartchips.
`createActionTriggers[]`	`object (createActionTriggers)` Erforderlich für das Erstellen von Drittanbieterressourcen. Eine Liste von Triggern zum Erstellen von Ressourcen in einem Drittanbieterdienst über das @-Menü. Weitere Informationen finden Sie unter Drittanbieterressourcen mit Smartchips erstellen.

OnFileScopeGrantedTrigger

Eine Konfiguration für einen kontextbezogenen Trigger, der ausgelöst wird, wenn das Dialogfeld für den Bereich der Anfragedatei mit CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); und der Nutzer die Autorisierung für den Bereich drive.file gewährt.

JSON-Darstellung
{ "runFunction": string }

Felder
`runFunction`	`string` Der Name der Funktion, die ausgeführt werden soll, wenn der Bereich `drive.file` gewährt wurde. Falls angegeben, musst du diese Funktion implementieren, um ein Array von `Card`-Objekten zur Anzeige auf der Add-on-UI zu erstellen und zurückzugeben.

LinkPreviewTriggers

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

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

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

Felder
`labelText`	`string` Erforderlich. Text für einen Beispiel-Smartchip, der Nutzer auffordert, sich eine Vorschau des Links anzusehen, z. B. `Example: Support case`. Dieser Text ist statisch und wird angezeigt, bevor Nutzer das Add-on ausführen.
`localizedLabelText`	`map (key: string, value: string)` Optional. Karte von `labelText` zur Lokalisierung in andere Sprachen. Formatiere die Sprache in ISO 639 und das Land/die Region in ISO 3166, getrennt durch einen Bindestrich `-`. Zum Beispiel: `en-US`. Wenn die Sprache eines Nutzers in den Schlüsseln der Karte vorhanden ist, sieht der Nutzer die lokalisierte Version von `labelText`.
`patterns[]`	`object (UriPattern)` Erforderlich. Ein Array mit URL-Mustern, die das Add-on auslösen, um Vorschaulinks anzuzeigen.
`runFunction`	`string` Erforderlich. Der Name der Funktion, die ausgeführt werden soll, wenn der Nutzer den Bereich `https://www.googleapis.com/auth/workspace.linkpreview` autorisiert. Falls angegeben, müssen Sie diese Funktion implementieren, um ein Ereignisobjekt zu akzeptieren, das `EDITOR_NAME.matchedUrl.url` als Argument enthält, und ein einzelnes Objekt `Card` zurückzugeben, das eine Linkvorschau auf der Add-on-Benutzeroberfläche anzeigt.
`logoUrl`	`string` Optional. Das Symbol, das auf dem Smartchip und der Vorschaukarte angezeigt wird. Wenn keine Angabe gemacht wird, wird für das Add-on das Symbolleistensymbol `logoUrl` verwendet.

UriPattern

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

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

Felder

Felder
`hostPattern`	`string` Erforderlich für jedes URL-Muster für die Vorschau. Die Domain des URL-Musters. Das Add-on zeigt eine Vorschau der Links an, die diese Domain in der URL enthalten. Um Links für eine bestimmte Subdomain, z. B. `subdomain.example.com`, in der Vorschau anzuzeigen, fügen Sie die Subdomain hinzu. Wenn Sie Vorschaulinks für die gesamte Domain sehen möchten, geben Sie ein Platzhalterzeichen mit einem Sternchen (``) als Subdomain an. Beispiel: `.example.com` stimmt mit `subdomain.example.com` und `another.subdomain.example.com` überein.
`pathPrefix`	`string` Optional. Der Pfad, der die Domain von `hostPattern` anhängt. Wenn das URL-Hostmuster beispielsweise `support.example.com` lautet, verwenden Sie `cases`, um URLs für Fälle, die unter `support.example.com/cases/` gehostet werden, abzugleichen. Wenn alle URLs in der Domain des Hostmusters übereinstimmen sollen, lassen Sie `pathPrefix` leer.

hostPattern

string

Erforderlich für jedes URL-Muster für die Vorschau. Die Domain des URL-Musters. Das Add-on zeigt eine Vorschau der Links an, die diese Domain in der URL enthalten. Um Links für eine bestimmte Subdomain, z. B. subdomain.example.com, in der Vorschau anzuzeigen, fügen Sie die Subdomain hinzu. Wenn Sie Vorschaulinks für die gesamte Domain sehen möchten, geben Sie ein Platzhalterzeichen mit einem Sternchen (*) als Subdomain an.

Beispiel: *.example.com stimmt mit subdomain.example.com und another.subdomain.example.com überein.

pathPrefix

string

Optional. Der Pfad, der die Domain von hostPattern anhängt.

Wenn das URL-Hostmuster beispielsweise support.example.com lautet, verwenden Sie cases, um URLs für Fälle, die unter support.example.com/cases/ gehostet werden, abzugleichen.

Wenn alle URLs in der Domain des Hostmusters übereinstimmen sollen, lassen Sie pathPrefix leer.

CreateActionTriggers

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

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

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

Felder
`id`	`string` Erforderlich. Die eindeutige ID zur Unterscheidung dieses Erweiterungspunkts. Die ID kann bis zu 64 Zeichen lang sein und muss das Format `[a-zA-Z0-9-]+.` haben.
`labelText`	`string` Erforderlich. Der Text im @-Menü, z. B. `Create support case`.
`localizedLabelText`	`map (key: string, value: string)` Optional. Karte von `labelText` zur Lokalisierung in andere Sprachen. Formatiere die Sprache in ISO 639 und das Land/die Region in ISO 3166, getrennt durch einen Bindestrich `-`. Zum Beispiel: `en-US`. Wenn die Sprache eines Nutzers in den Schlüsseln der Karte vorhanden ist, sieht der Nutzer die lokalisierte Version von `labelText`.
`runFunction`	`string` Erforderlich. Der Name der Funktion, die ausgeführt werden soll, wenn ein Nutzer im @-Menü einen Erweiterungspunkt auswählt. Die Funktion sollte eine Formularkarte mit Eingaben zum Erstellen der Drittanbieterressource zurückgeben.
`logoUrl`	`string` Optional. Das Symbol, das im @-Menü angezeigt wird. Wenn keine Angabe gemacht wird, wird für das Add-on das Symbolleistensymbol `logoUrl` verwendet.