Editor-Manifestressource

Die Ressourcenkonfiguration, mit der Inhalt und Verhalten von Google Workspace-Add-ons in den Editoren definiert werden. Google Workspace-Add‑on-Manifeste müssen alle Komponenten enthalten, die als Erforderlich gekennzeichnet sind, wenn sie den Editor erweitern.

Bearbeiter

Die Google Workspace-Add‑on-Manifestkonfiguration 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)
      }
  }
Felder
homepageTrigger

object (HomepageTrigger)

Mit dieser Triggerfunktion wird die Startseite des Add-ons in der Hostanwendung erstellt. Dadurch wird addOns.common.homepageTrigger überschrieben.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Erforderlich, wenn das Add-on Verhalten enthält, das sich auf das aktuelle Dokument bezieht und ausgelöst wird, wenn der Nutzer den drive.file-Bereich autorisiert.
linkPreviewTriggers[]

object (LinkPreviewTriggers)

Für Linkvorschauen erforderlich. Eine Liste der Trigger 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)

Für die Erstellung von Drittanbieterressourcen erforderlich. Eine Liste der Trigger 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 im Dialogfeld für den Anforderungsdateibereich 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 Datei in Google Docs, Google Sheets 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. Der Text für einen Beispiel-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 Map von labelText, die in andere Sprachen lokalisiert werden soll. Formatieren Sie die Sprache gemäß ISO 639 und das Land/die Region gemäß ISO 3166. Die beiden Angaben müssen durch einen Bindestrich - getrennt werden.
patterns[]

object (UriPattern)

Erforderlich. Ein Array von URL-Mustern, die die Vorschau von Links im Add-on auslösen.
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 ein matchedUrl.url-Attribut mit der URL für die Vorschau enthält, und ein Card-Objekt zurückgeben.
logoUrl

string

Optional. Das Symbol, das im Smart-Chip und auf der Vorschaukarte angezeigt wird. Wenn nicht angegeben, 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

Erforderlich für jedes URL-Muster. Die Domain des URL-Musters. Das Add-on zeigt eine Vorschau von Links an, die diese Domain enthalten. Wenn Sie alle Subdomains abgleichen möchten, verwenden Sie ein Platzhaltersternchen (*).
pathPrefix

string

Optional. Der Pfad, der an die Domain angehängt wird. Wenn alle URLs in der Domain abgeglichen werden sollen, lassen Sie pathPrefix leer.

CreateActionTriggers

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

Informationen zum Einrichten dieses Triggers für ein Google Workspace-Add‑on finden Sie unter Drittanbieterressourcen mit Smart Chips 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 Format [a-zA-Z0-9-]+..
labelText

string

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

map (key: string, value: string)

Optional. Eine Karte von labelText, die lokalisiert werden soll. Formatiere die Sprache im ISO 639-Format und das Land/die Region im ISO 3166-Format, 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 Formular-Karte zurückgeben.
logoUrl

string

Optional. Das Symbol, das im @-Menü angezeigt wird. Wenn nichts angegeben ist, wird das Symbol des Add-ons in der Symbolleiste verwendet: logoUrl.