REST Resource: projects.deployments

Ressource: Bereitstellung

Eine Bereitstellung eines Google Workspace-Add-ons

JSON-Darstellung 
{
  "name": string,
  "oauthScopes": [
    string
  ],
  "addOns": {
    object (AddOns)
  },
  "etag": string
}
Felder
name

string

Der Name der Bereitstellungsressource. Beispiel: projects/123/deployments/my_deployment.
oauthScopes[]

string

Die Liste der Google OAuth-Bereiche, für die die Einwilligung des Endnutzers eingeholt werden muss, bevor ein Add-on-Endpunkt ausgeführt wird.
addOns

object (AddOns)

Die Konfiguration des Google Workspace-Add-ons.
etag

string

Dieser Wert wird vom Server basierend auf der Version der Bereitstellung im Speicher berechnet und kann bei Aktualisierungs- und Löschanfragen gesendet werden, damit der Client vor dem Fortfahren einen aktuellen Wert hat.

AddOns

Eine Google Workspace-Add-on-Konfiguration.

JSON-Darstellung 
{
  "common": {
    object (CommonAddOnManifest)
  },
  "gmail": {
    object (GmailAddOnManifest)
  },
  "drive": {
    object (DriveAddOnManifest)
  },
  "calendar": {
    object (CalendarAddOnManifest)
  },
  "docs": {
    object (DocsAddOnManifest)
  },
  "sheets": {
    object (SheetsAddOnManifest)
  },
  "slides": {
    object (SlidesAddOnManifest)
  },
  "httpOptions": {
    object (HttpOptions)
  }
}
Felder
common

object (CommonAddOnManifest)

Eine Konfiguration, die für alle Google Workspace-Add-ons gilt.
gmail

object (GmailAddOnManifest)

Konfiguration des Gmail-Add-ons
drive

object (DriveAddOnManifest)

Konfiguration des Drive-Add-ons
calendar

object (CalendarAddOnManifest)

Konfiguration des Kalender-Add-ons
docs

object (DocsAddOnManifest)

Konfiguration des Docs-Add-ons
sheets

object (SheetsAddOnManifest)

Konfiguration des Tabellen-Add-ons
slides

object (SlidesAddOnManifest)

Konfiguration des Präsentationen-Add-ons
httpOptions

object (HttpOptions)

Optionen zum Senden von Anfragen an Add-on-HTTP-Endpunkte

CommonAddOnManifest

Add-on-Konfiguration, die für alle Add-on-Hostanwendungen freigegeben wird.

JSON-Darstellung 
{
  "name": string,
  "logoUrl": string,
  "layoutProperties": {
    object (LayoutProperties)
  },
  "addOnWidgetSet": {
    object (AddOnWidgetSet)
  },
  "useLocaleFromApp": boolean,
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "universalActions": [
    {
      object (UniversalActionExtensionPoint)
    }
  ],
  "openLinkUrlPrefixes": array
}
Felder
name

string

Erforderlich. Der Anzeigename des Add-ons.
logoUrl

string

Erforderlich. Die URL für das Logobild, das in der Symbolleiste des Add-ons angezeigt wird.
layoutProperties

object (LayoutProperties)

Gängige Layouteigenschaften für Add-on-Karten.
addOnWidgetSet

object (AddOnWidgetSet)

Die im Add-on verwendeten Widgets. Wenn dieses Feld nicht angegeben ist, wird die Standardgruppe verwendet.
useLocaleFromApp

boolean

Gibt an, ob Informationen zur Sprache und Region von der Host-App übergeben werden sollen.
homepageTrigger

object (HomepageExtensionPoint)

Definiert einen Endpunkt, der in jedem Kontext und auf jedem Host ausgeführt wird. Alle Karten, die mit dieser Funktion generiert werden, sind für den Nutzer immer verfügbar, können aber von kontextbezogenen Inhalten verdeckt werden, wenn dieses Add-on gezieltere Trigger deklariert.
universalActions[]

object (UniversalActionExtensionPoint)

Hier wird eine Liste von Erweiterungspunkten im universellen Aktionsmenü definiert, das als Einstellungsmenü für das Add-on dient. Der Erweiterungspunkt kann eine Link-URL zum Öffnen oder ein Endpunkt sein, der als Formulareinreichung ausgeführt wird.
openLinkUrlPrefixes

array (ListValue format)

Für eine OpenLink-Aktion kann nur eine URL mit einem HTTPS-, MAILTO- oder TEL-Schema verwendet werden. Bei HTTPS-Links muss die URL außerdem mit einem der in der Zulassungsliste angegebenen Präfixe übereinstimmen. Wenn das Präfix das Schema nicht enthält, wird HTTPS angenommen. HTTP-Links werden automatisch in HTTPS-Links umgeschrieben.

LayoutProperties

Kartenlayout-Eigenschaften, die für alle Add-on-Hostanwendungen freigegeben sind.

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

string

Die Hauptfarbe des Add-ons. Damit wird die Farbe der Symbolleiste festgelegt. Wenn keine primäre Farbe festgelegt ist, wird der vom Framework bereitgestellte Standardwert verwendet.
secondaryColor

string

Die sekundäre Farbe des Add-ons. Hiermit wird die Farbe der Schaltflächen festgelegt. Wenn die Primärfarbe festgelegt ist, aber keine Sekundärfarbe, ist die Sekundärfarbe mit der Primärfarbe identisch. Wenn weder die primäre noch die sekundäre Farbe festgelegt ist, wird der vom Framework bereitgestellte Standardwert verwendet.
useNewMaterialDesign

boolean

Aktiviert das Materialdesign für Karten.

AddOnWidgetSet

Die Widget-Subsets, die von einem Add-on verwendet werden.

JSON-Darstellung 
{
  "usedWidgets": [
    enum (WidgetType)
  ]
}
Felder
usedWidgets[]

enum (WidgetType)

Liste der in einem Add-on verwendeten Widgets.

WidgetType

Der Widget-Typ. WIDGET_TYPE_UNSPECIFIED ist das grundlegende Widget-Set.

Enums
WIDGET_TYPE_UNSPECIFIED Der Standard-Widget-Satz.
DATE_PICKER Die Datumsauswahl.
STYLED_BUTTONS Zu den stilisierten Schaltflächen gehören ausgefüllte und deaktivierte Schaltflächen.
PERSISTENT_FORMS Mit persistenten Formularen können Formularwerte bei Aktionen beibehalten werden.
UPDATE_SUBJECT_AND_RECIPIENTS Betreff und Empfänger eines Entwurfs aktualisieren
GRID_WIDGET Das Raster-Widget.
ADDON_COMPOSE_UI_ACTION Eine Gmail-Add-on-Aktion, die auf die Benutzeroberfläche zum Verfassen von E-Mails des Add-ons angewendet wird.

HomepageExtensionPoint

Gängiges Format für die Deklaration der Startseitenansicht eines Add-ons.

JSON-Darstellung 
{
  "runFunction": string,
  "enabled": boolean
}
Felder
runFunction

string

Erforderlich. Der Endpunkt, der ausgeführt wird, wenn dieser Erweiterungspunkt aktiviert ist.
enabled

boolean

Optional. Wenn dieser Wert auf false festgelegt ist, wird die Startseitenansicht in diesem Kontext deaktiviert.

Wenn dieser Wert nicht festgelegt ist, wird standardmäßig true verwendet.

Wenn die benutzerdefinierte Startseitenansicht eines Add-ons deaktiviert ist, wird Nutzern stattdessen eine generische Übersichtskarte angezeigt.

UniversalActionExtensionPoint

Format für die Deklaration eines Erweiterungspunkts für universelle Menüelemente für Aktionen.

JSON-Darstellung 
{
  "label": string,

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

string

Erforderlich. Für Nutzer sichtbarer Text, der die Aktion beschreibt, die durch das Aktivieren dieses Erweiterungspunkts ausgeführt wird, z. B. „Neuen Kontakt hinzufügen“.
Union-Feld action_type. Erforderlich. Der Aktionstyp, der für ein universelles Menüelement unterstützt wird. Es kann sich dabei um einen Link zum Öffnen oder einen Endpunkt zum Ausführen handeln. Für action_type ist nur einer der folgenden Werte zulässig:
runFunction

string

Endpunkt, der von der UniversalAction ausgeführt werden soll.

GmailAddOnManifest

Eigenschaften, mit denen das Erscheinungsbild und die Ausführung eines Gmail-Add-ons angepasst werden.

JSON-Darstellung 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "authorizationCheckFunction": string
}
Felder
homepageTrigger

object (HomepageExtensionPoint)

Hiermit wird ein Endpunkt definiert, der in Kontexten ausgeführt wird, die nicht mit einem deklarierten kontextbezogenen Trigger übereinstimmen. Alle Karten, die mit dieser Funktion generiert werden, sind für den Nutzer immer verfügbar, können aber von kontextbezogenen Inhalten verdeckt werden, wenn dieses Add-on gezieltere Trigger deklariert.

Falls vorhanden, wird die Konfiguration aus addons.common.homepageTrigger überschrieben.
contextualTriggers[]

object (ContextualTrigger)

Hier werden die Bedingungen definiert, die das Add-on auslösen.
universalActions[]

object (UniversalAction)

Hier werden eine Reihe von universellen Aktionen für das Add-on definiert. Der Nutzer löst universelle Aktionen über das Menü der Add-on-Symbolleiste aus.
composeTrigger

object (ComposeTrigger)

Definiert den Trigger für die Erstellungszeit für ein Add-on für die Erstellungszeit. Dieser Trigger bewirkt, dass ein Add-on eine Aktion ausführt, wenn der Nutzer eine E-Mail verfasst. Alle Add-ons für die Erstellungszeit müssen den Umfang gmail.addons.current.action.compose haben, auch wenn sie den Entwurf möglicherweise nicht bearbeiten.
authorizationCheckFunction

string

Der Name eines Endpunkts, der überprüft, ob das Add-on alle erforderlichen Autorisierungen von Drittanbietern hat, indem die APIs der Drittanbieter geprüft werden. Wenn die Prüfung fehlschlägt, sollte die Funktion eine Ausnahme auslösen, um den Autorisierungsablauf zu starten. Diese Funktion wird vor jedem Aufruf des Add-ons aufgerufen, um eine reibungslose Nutzererfahrung zu ermöglichen.

ContextualTrigger

Hiermit wird ein Trigger definiert, der ausgelöst wird, wenn die geöffnete E-Mail bestimmte Kriterien erfüllt. Wenn der Trigger ausgelöst wird, wird ein bestimmter Endpunkt ausgeführt, in der Regel, um neue Karten zu erstellen und die Benutzeroberfläche zu aktualisieren.

JSON-Darstellung 
{
  "onTriggerFunction": string,

  // Union field trigger can be only one of the following:
  "unconditional": {
    object (UnconditionalTrigger)
  }
  // End of list of possible types for union field trigger.
}
Felder
onTriggerFunction

string

Erforderlich. Der Name des Endpunkts, der aufgerufen werden soll, wenn eine Nachricht mit dem Trigger übereinstimmt.
Union-Feld trigger. Der Triggertyp bestimmt die Bedingungen, unter denen das Add-on in Gmail angezeigt wird. Für trigger ist nur einer der folgenden Werte zulässig:
unconditional

object (UnconditionalTrigger)

Bedingungslose Trigger werden ausgeführt, wenn eine E-Mail-Nachricht geöffnet wird.

UnconditionalTrigger

Dieser Typ hat keine Felder.

Ein Trigger, der ausgelöst wird, wenn eine E-Mail-Nachricht geöffnet wird.

UniversalAction

Eine Aktion, die unabhängig vom Nachrichtenkontext immer im Menü der Add-on-Symbolleiste verfügbar ist.

JSON-Darstellung 
{
  "text": string,

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

string

Erforderlich. Für Nutzer sichtbarer Text, der die Aktion beschreibt, z. B. „Neuen Kontakt hinzufügen“
Union-Feld action_type. Der Aktionstyp bestimmt das Verhalten von Gmail, wenn der Nutzer die Aktion auslöst. Für action_type ist nur einer der folgenden Werte zulässig:
runFunction

string

Ein Endpunkt, der aufgerufen wird, wenn der Nutzer die Aktion auslöst. Weitere Informationen finden Sie im Leitfaden für universelle Aktionen.

ComposeTrigger

Ein Trigger, der aktiviert wird, wenn der Nutzer eine E-Mail verfasst.

JSON-Darstellung 
{
  "actions": [
    {
      object (MenuItemExtensionPoint)
    }
  ],
  "draftAccess": enum (DraftAccess)
}
Felder
actions[]

object (MenuItemExtensionPoint)

Definiert die Aktionen für ein Add-on für die Erstellungszeit. Das sind Aktionen, die Nutzer bei einem Add-on für die Erstellungszeit auslösen können.
draftAccess

enum (DraftAccess)

Hiermit wird die Datenzugriffsebene definiert, wenn ein Add-on zur Erstellungszeit ausgelöst wird.

DraftAccess

Ein Enum, das die Datenzugriffsebene definiert, die für den Zusammenstellungstrigger erforderlich ist.

Enums
UNSPECIFIED Standardwert, wenn für „draftaccess“ nichts festgelegt ist.
NONE Der Trigger für das Erstellen kann nicht auf Daten des Entwurfs zugreifen, wenn ein Add-on für das Erstellen ausgelöst wird.
METADATA Erteilt dem Trigger für die Erstellung die Berechtigung, auf die Metadaten des Entwurfs zuzugreifen, wenn ein Add-on für die Erstellung ausgelöst wird. Dazu gehört die Zielgruppenliste, z. B. die Liste der Empfänger und Cc-Empfänger einer Entwurfsnachricht.

DriveAddOnManifest

Eigenschaften, mit denen das Aussehen und die Ausführung eines Drive-Add-ons angepasst werden kann.

JSON-Darstellung 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onItemsSelectedTrigger": {
    object (DriveExtensionPoint)
  }
}
Felder
homepageTrigger

object (HomepageExtensionPoint)

Falls vorhanden, wird die Konfiguration aus addons.common.homepageTrigger überschrieben.
onItemsSelectedTrigger

object (DriveExtensionPoint)

Entspricht dem Verhalten, das ausgeführt wird, wenn Elemente in der entsprechenden Drive-Ansicht ausgewählt werden, z. B. in der Dokumentliste „Meine Drive-Ablage“.

DriveExtensionPoint

Gängiges Format für die Deklaration von Auslösern für ein Drive-Add-on.

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

string

Erforderlich. Der Endpunkt, der ausgeführt wird, wenn der Erweiterungspunkt aktiviert wird.

CalendarAddOnManifest

Eigenschaften, mit denen das Aussehen und die Ausführung eines Kalender-Add-ons angepasst werden kann.

JSON-Darstellung 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "createSettingsUrlFunction": string,
  "eventOpenTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventUpdateTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventAttachmentTrigger": {
    object (MenuItemExtensionPoint)
  },
  "currentEventAccess": enum (EventAccess)
}
Felder
homepageTrigger

object (HomepageExtensionPoint)

Definiert einen Endpunkt, der in Kontexten ausgeführt wird, die keinem deklarierten kontextbezogenen Trigger entsprechen. Alle Karten, die mit dieser Funktion generiert werden, sind für den Nutzer immer verfügbar, können aber von kontextbezogenen Inhalten verdeckt werden, wenn dieses Add-on gezieltere Trigger deklariert.

Falls vorhanden, wird die Konfiguration aus addons.common.homepageTrigger überschrieben.
conferenceSolution[]

object (ConferenceSolution)

Hier werden die Konferenzlösungen dieses Add-ons definiert. Konferenz-Add-ons von Drittanbietern können nur in Apps Script erstellt werden.
createSettingsUrlFunction

string

Ein Endpunkt, der eine URL zur Seite mit den Einstellungen des Add-ons erstellt.
eventOpenTrigger

object (CalendarExtensionPoint)

Ein Endpunkt, der ausgelöst wird, wenn ein Ereignis zum Ansehen oder Bearbeiten geöffnet wird.
eventUpdateTrigger

object (CalendarExtensionPoint)

Ein Endpunkt, der ausgelöst wird, wenn das offene Ereignis aktualisiert wird.
eventAttachmentTrigger

object (MenuItemExtensionPoint)

Eine Konfiguration für einen kontextbezogenen Trigger, der ausgelöst wird, wenn der Nutzer im Drop-down-Menü von Google Kalender auf den Anbieter von Add-on-Anhängen klickt.
currentEventAccess

enum (EventAccess)

Hier wird die Datenzugriffsebene festgelegt, wenn ein Ereignis-Add-on ausgelöst wird.

ConferenceSolution

Hier werden konferenzbezogene Werte definiert. Konferenz-Add-ons von Drittanbietern können nur in Apps Script erstellt werden.

JSON-Darstellung 
{
  "onCreateFunction": string,
  "id": string,
  "name": string,
  "logoUrl": string
}
Felder
onCreateFunction

string

Erforderlich. Der Endpunkt, der aufgerufen werden soll, wenn Konferenzdaten erstellt werden sollen.
id

string

Erforderlich. IDs müssen innerhalb eines Add-ons eindeutig für Konferenzlösungen zugewiesen werden. Andernfalls wird beim Auslösen des Add-ons möglicherweise die falsche Konferenzlösung verwendet. Sie können den Anzeigenamen eines Add-ons ändern, die ID sollte jedoch nicht geändert werden.
name

string

Erforderlich. Der Anzeigename der Konferenzlösung.
logoUrl

string

Erforderlich. Die URL für das Logobild der Konferenzlösung.

CalendarExtensionPoint

Gängiges Format für die Deklaration von Auslösern für ein Kalender-Add-on.

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

string

Erforderlich. Der Endpunkt, der ausgeführt wird, wenn dieser Erweiterungspunkt aktiviert ist.

EventAccess

Ein Enum, das die Datenzugriffsebene für Ereignisauslöser definiert.

Enums
UNSPECIFIED Standardwert, wenn für „eventAccess“ nichts festgelegt ist.
METADATA Ermöglicht Ereignisauslösern den Zugriff auf die Metadaten von Ereignissen, z. B. Ereignis-ID und Kalender-ID.
READ Ermöglicht Ereignistriggern den Zugriff auf alle angegebenen Ereignisfelder, einschließlich Metadaten, Teilnehmern und Konferenzdaten.
WRITE Ermöglicht Ereignisauslösern den Zugriff auf die Metadaten von Ereignissen und die Ausführung aller Aktionen, einschließlich des Hinzufügens von Teilnehmern und des Festlegens von Konferenzdaten.
READ_WRITE Ermöglicht Ereignistriggern den Zugriff auf alle angegebenen Ereignisfelder, einschließlich Metadaten, Teilnehmern und Konferenzdaten, sowie die Ausführung aller Aktionen.

DocsAddOnManifest

Eigenschaften, mit denen das Aussehen und die Ausführung eines Google Docs-Add-ons angepasst werden kann.

JSON-Darstellung 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (DocsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ],
  "createActionTriggers": [
    {
      object (CreateActionExtensionPoint)
    }
  ]
}
Felder
homepageTrigger

object (HomepageExtensionPoint)

Falls vorhanden, wird die Konfiguration aus addons.common.homepageTrigger überschrieben.
onFileScopeGrantedTrigger

object (DocsExtensionPoint)

Endpunkt, der ausgeführt wird, wenn für dieses Dokument/Nutzerpaar eine Autorisierung auf Dateiebene gewährt wird.
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

Eine Liste von Erweiterungspunkten für die Vorschau von Links in einem Google Docs-Dokument. Weitere Informationen finden Sie unter Vorschaulinks mit Smartchips.
createActionTriggers[]

object (CreateActionExtensionPoint)

Eine Liste von Erweiterungspunkten zum Erstellen von Drittanbieterressourcen in Google Workspace-Anwendungen. Weitere Informationen finden Sie unter Drittanbieterressourcen über das Dreipunkt-Menü erstellen.

DocsExtensionPoint

Gängiges Format für die Deklaration von Triggern für ein Docs-Add-on.

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

string

Erforderlich. Der Endpunkt, der ausgeführt wird, wenn dieser Erweiterungspunkt aktiviert ist.

LinkPreviewExtensionPoint

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

JSON-Darstellung 
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "patterns": [
    {
      object (UriPattern)
    }
  ],
  "runFunction": string,
  "logoUrl": string
}
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 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. Formatieren Sie die Sprache im ISO 639-Format und das Land/die Region im ISO 3166-Format, getrennt durch einen Bindestrich -. Zum Beispiel: en-US.

Wenn das Gebietsschema eines Nutzers in den Schlüsseln der Karte enthalten ist, sieht der Nutzer die lokalisierte Version der labeltext.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
patterns[]

object (UriPattern)

Erforderlich. Eine Reihe von URL-Mustern, die das Add-on zum Anzeigen von Linkvorschauen auslösen.
runFunction

string

Erforderlich. Endpunkt, der ausgeführt wird, wenn eine Linkvorschau ausgelöst wird.
logoUrl

string

Optional. Das Symbol, das im Smartchip und auf der Vorschaukarte angezeigt wird. Wenn Sie das Feld leer lassen, wird das Symbol des Add-ons in der Symbolleiste (logourl) verwendet.

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 die Vorschau jedes URL-Musters. Die Domain des URL-Musters. Das Add-on zeigt eine Vorschau von Links an, die diese Domain in der URL enthalten. Wenn Sie eine Vorschau für Links für eine bestimmte Subdomain wie subdomain.example.com sehen möchten, geben Sie die Subdomain an. 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 führt *.example.com zu Übereinstimmungen mit subdomain.example.com und another.subdomain.example.com.
pathPrefix

string

Optional. Der Pfad, an den die Domain der hostpattern angehängt wird.

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

Wenn alle URLs in der Domain des Hostmusters abgeglichen werden sollen, lassen Sie pathprefix leer.

CreateActionExtensionPoint

Die Konfiguration für einen Trigger, der ausgelöst wird, wenn ein Nutzer den Workflow zum Erstellen von Ressourcen in einer Google Workspace-Anwendung aufruft. Weitere Informationen finden Sie unter Drittanbieterressourcen über das Dreipunkt-Menü erstellen.

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

string

Erforderlich. Die eindeutige ID, um diesen Erweiterungspunkt zu unterscheiden. Die ID darf maximal 64 Zeichen lang sein und sollte das Format [a-zA-Z0-9-]+ haben.
labelText

string

Erforderlich. Der Text, der neben einem Symbol für den Einstiegspunkt zur Ressourcenerstellung angezeigt wird, z. B. Create 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. Formatieren Sie die Sprache im ISO 639-Format und das Land/die Region im ISO 3166-Format, getrennt durch einen Bindestrich -. Zum Beispiel: en-US.

Wenn das Gebietsschema eines Nutzers in den Schlüsseln der Karte enthalten ist, sieht der Nutzer die lokalisierte Version der labeltext.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
runFunction

string

Erforderlich. Endpunkt, der ausgeführt wird, wenn ein Workflow zum Erstellen einer Ressource ausgelöst wird, um einen Link zu erstellen.
logoUrl

string

Optional. Das Symbol, das für den Einstiegspunkt zur Ressourcenerstellung angezeigt wird. Wenn Sie das Feld auslassen, wird das Symbol logourl der Symbolleiste des Add-ons für das Menü verwendet.

SheetsAddOnManifest

Eigenschaften, mit denen das Aussehen und die Ausführung eines Google Tabellen-Add-ons angepasst werden kann.

JSON-Darstellung 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SheetsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
Felder
homepageTrigger

object (HomepageExtensionPoint)

Falls vorhanden, wird die Konfiguration aus addons.common.homepageTrigger überschrieben.
onFileScopeGrantedTrigger

object (SheetsExtensionPoint)

Endpunkt, der ausgeführt wird, wenn für dieses Dokument/Nutzerpaar eine Autorisierung auf Dateiebene gewährt wird.
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

Eine Liste von Erweiterungspunkten für die Vorschau von Links in einem Google Tabellendokument. Weitere Informationen finden Sie unter Vorschaulinks mit Smartchips.

SheetsExtensionPoint

Gängiges Format für die Deklaration von Triggern für ein Google Tabellen-Add-on.

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

string

Erforderlich. Der Endpunkt, der ausgeführt wird, wenn dieser Erweiterungspunkt aktiviert ist.

SlidesAddOnManifest

Eigenschaften, mit denen das Erscheinungsbild und die Ausführung eines Google Präsentationen-Add-ons angepasst werden kann.

JSON-Darstellung 
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SlidesExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
Felder
homepageTrigger

object (HomepageExtensionPoint)

Falls vorhanden, wird die Konfiguration aus addons.common.homepageTrigger überschrieben.
onFileScopeGrantedTrigger

object (SlidesExtensionPoint)

Endpunkt, der ausgeführt wird, wenn für dieses Dokument/Nutzerpaar eine Autorisierung auf Dateiebene gewährt wird.
linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

Eine Liste von Erweiterungspunkten für die Vorschau von Links in einem Google Präsentationen-Dokument. Weitere Informationen finden Sie unter Vorschaulinks mit Smartchips.

SlidesExtensionPoint

Gängiges Format für die Deklaration von Auslösern für ein Add-on in Google Präsentationen.

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

string

Erforderlich. Der Endpunkt, der ausgeführt wird, wenn dieser Erweiterungspunkt aktiviert ist.

HttpOptions

Optionen zum Senden von Anfragen an HTTP-Endpunkte von Add-ons.

JSON-Darstellung 
{
  "authorizationHeader": enum (HttpAuthorizationHeader)
}
Felder
authorizationHeader

enum (HttpAuthorizationHeader)

Konfiguration für das Token, das im HTTP-Autorisierungsheader gesendet wird.

HttpAuthorizationHeader

Autorisierungsheader, der in Add-on-HTTP-Anfragen gesendet wird.

Enums
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED Standardwert, entspricht SYSTEM_ID_TOKEN.
SYSTEM_ID_TOKEN Senden Sie ein ID-Token für das Systemdienstkonto des projektspezifischen Google Workspace-Add-ons (Standard).
USER_ID_TOKEN Senden Sie ein ID-Token für den Endnutzer.
NONE Senden Sie keinen Authentifizierungsheader.

Methoden

create

 Erstellt eine Bereitstellung mit dem angegebenen Namen und der angegebenen Konfiguration.

delete

 Löscht die Bereitstellung mit dem angegebenen Namen.

get

 Ruft die Bereitstellung mit dem angegebenen Namen ab.

getInstallStatus

 Ruft den Installationsstatus einer Testbereitstellung ab.

install

 Hiermit wird eine Bereitstellung zum Testen in Ihrem Konto installiert.

list

 Listet alle Bereitstellungen in einem bestimmten Projekt auf.

replaceDeployment

 Erstellt oder ersetzt ein Deployment mit dem angegebenen Namen.

uninstall

 Eine Testimplementierung wird aus dem Konto des Nutzers deinstalliert.