Editor-Manifestressource

Die Ressourcenkonfiguration, die zum Definieren Google Workspace-Add-on und Verhalten innerhalb der Redakteure. Manifeste für Google Workspace-Add-ons müssen Folgendes enthalten: Alle Komponenten, die als erforderlich gekennzeichnet sind, wenn sie den Editor erweitern.

Bearbeiter

Manifestkonfiguration des Google Workspace-Add-ons für Editor-Erweiterungen. Weitere Informationen finden Sie unter Bearbeiter 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 das Add-on homepage im Feld Host-App. Dies überschreibt addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Erforderlich, wenn Ihr Add-on Verhaltensweisen aufweist, die für das aktuelle Ereignis relevant sind Editor-Dokument, das ausgelöst wird, wenn der Nutzer den Bereich drive.file autorisiert.

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Erforderlich für Linkvorschauen. Eine Liste mit Triggern für Vorschau-Links in einer Datei von Google Docs, Google Tabellen oder Google Präsentationen anzeigen. Weitere Informationen finden Sie im Hilfeartikel Vorschaulinks mit Smartchips.

createActionTriggers[]

object (createActionTriggers)

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

OnFileScopeGrantedTrigger

Eine Konfiguration für einen kontextbezogenen Trigger, der ausgelöst wird, wenn der Dialogfeld zum Anfordern des Dateiumfangs mit CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build(); und der Nutzer gewährt drive.file die Autorisierung des Zuständigkeitsbereichs.

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

string

Der Name der Funktion, die ausgeführt werden soll, wenn der Bereich drive.file ist: gewährt wird. Wenn angegeben, müssen Sie diese Funktion implementieren, um ein Array von zurückgeben Card-Objekte, die in der Add-on-UI angezeigt werden.

LinkPreviewTriggers

Konfiguration für einen Trigger, der ausgelöst wird, wenn ein Nutzer einen Link eingibt oder einfügt Drittanbieter- oder Drittanbieterdienstes in ein Google Tabellen- oder Google Präsentationen-Datei hochladen.

So richten Sie diesen Trigger für ein Google Workspace-Add-on ein: Siehe 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 dazu auffordert um eine Vorschau des Links anzuzeigen, 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. Eine Karte von labelText, die in andere Sprachen lokalisiert werden soll. Sprache formatieren in ISO 639 und Land/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 von URL-Mustern, die das Add-on zur Vorschau von Links auslösen.
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. Wenn angegeben, müssen Sie diese Funktion implementieren, um ein Ereignisobjekt mit EDITOR_NAME.matchedUrl.url als Argument anzunehmen und ein einzelnes Card-Objekt zurückzugeben, das eine Linkvorschau in der Add-on-Benutzeroberfläche anzeigt.
logoUrl

string

Optional. Das auf dem Smartchip und der Vorschaukarte angezeigte Symbol. Wenn wird weggelassen, verwendet das Add-on das Symbolleistensymbol logoUrl.

UriPattern

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

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

string

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

Beispielsweise stimmt *.example.com mit subdomain.example.com überein. und another.subdomain.example.com.

pathPrefix

string

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

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

Lassen Sie pathPrefix leer, um alle URLs in der Hostmusterdomain abzugleichen.

CreateActionTriggers

Konfiguration für einen Trigger, der ausgelöst wird, wenn ein Nutzer einen Drittanbieter auswählt Menüpunkt 'Integration' aus dem @-Menü von Google Docs.

So richten Sie diesen Trigger für ein Google Workspace-Add-on ein: Siehe Mit Smartchips Ressourcen von Drittanbietern erstellen

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

string

Erforderlich. Die eindeutige ID zur Unterscheidung dieser Erweiterung Punkt. Die ID kann bis zu 64 Zeichen lang sein und muss folgendes Format haben: [a-zA-Z0-9-]+.
labelText

string

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

map (key: string, value: string)

Optional. Eine Karte von labelText, die in andere Sprachen lokalisiert werden soll. Sprache formatieren in ISO 639 und Land/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 einen Erweiterungspunkt aus dem @-Menü auswählt. Die Funktion sollte eine Formularkarte mit Eingaben zum Erstellen der Drittanbieterressource zurückgeben.
logoUrl

string

Optional. Das im @-Menü angezeigte Symbol. Wenn wird weggelassen, verwendet das Add-on das Symbolleistensymbol logoUrl.