Glossar

Die folgenden Begriffe werden in dieser Dokumentation verwendet.

Add-on für Google Kalender-Konferenzen

Eine spezielle Art von Add-on, mit dem Konferenzanbieter Videokonferenzoptionen in Google Kalender-Terminen präsentieren können. Diese Add-ons erfordern eine gut entwickelte Konferenzlösung, mit der das Add-on verbunden werden kann. Aufgrund dieser Anforderung müssen die meisten Entwickler kein Add-on für Kalenderkonferenzen erstellen.

Weitere Informationen finden Sie unter Add-ons für Google Kalender-Konferenzen. Informationen dazu, wie Sie ein Kalender-Konferenz-Add-on in ein Google Workspace-Add-on umwandeln, finden Sie unter Veröffentlichte Add-ons upgraden.

Infokarte

Eine einzelne „Seite“ einer Add-on-UI. Karten bestehen aus verschiedenen Widget-Objekten (Schaltflächen, Textfelder, Überschriften usw.).

Weitere Informationen findest du unter Infokarten.

Kartenbasiert

Ein Add-on, dessen Benutzeroberfläche als Bereich in der Seitenleiste oder auf Mobilgeräten als weiteres Aktivitätsfenster angezeigt wird, das über das Menü aufgerufen wird. Das Add-on hat oben eine Symbolleiste, die das Add-on identifiziert und eine Karte anzeigt – im Wesentlichen eine „Seite“ der UI des Add-ons.

Google Workspace-Add-ons sind kartenbasiert.

Konferenzdaten

Die Informationen, die Google Kalender benötigt, damit Nutzer Konferenzen mit Drittanbietern erstellen und daran teilnehmen können, die über ein Google Workspace-Add-on oder ein Kalender-Add-on für Konferenzen aktiviert wurden.

Weitere Informationen finden Sie unter Konferenzdaten.

Konferenzlösung

Darstellung einer Videokonferenz eines Drittanbieters, die in Google Kalender mit dem Google Workspace-Add-on oder dem Google Kalender-Konferenz-Add-on erstellt werden kann.

Weitere Informationen finden Sie unter Konferenzlösungen.

Kontext

Der aktuelle Status der Hostanwendung. Beispielsweise sehen Sie, welche Nachricht derzeit in Gmail geöffnet wird, welcher Kalendertermin Sie bearbeiten oder welche Drive-Dateien Sie im aktuellen Kontext der Hostanwendung ausgewählt haben. Der Kontext sowie andere Informationen werden in einem Ereignisobjekt erfasst, das als Parameter an die Triggerfunktion übergeben wird.

Kontextbezogenes Auslösen

Definieren von Triggern, die ausgelöst werden, wenn der Nutzer einen bestimmten Kontext eingibt, z. B. eine E-Mail-Konversation in Gmail öffnet. Mit kontextbezogenem Trigger kann das Add-on eine UI bereitstellen, die für den jeweiligen Kontext relevant ist. Kontextuelle Trigger werden im Manifest des Add-on-Skriptprojekts konfiguriert und sind daher eine Art Manifest-Trigger.

Editor-Add-ons

Die ursprüngliche Gruppe von Add-on-Typen, bei denen nur Erweiterungen von Google Docs, Google Tabellen, Google Formulare oder Google Präsentationen zugelassen wurden. Editor-Add-ons sind nicht kartenbasiert. Stattdessen muss der Entwickler eine UI aus HTML- und CSS-Rohdaten erstellen. Jedes Editor-Add-on kann nur eine Hostanwendung erweitern.

Weitere Informationen finden Sie unter Editor-Add-ons.

Ereignisobjekt

Das JSON-Objekt, das automatisch erstellt wird, wenn Startseiten angefordert werden, wenn das Add-on Kontexte eingibt, auf die es reagieren muss, oder als Ergebnis von Nutzerinteraktionen mit Widgets in der Add-on-Oberfläche. Erstellte Ereignisobjekte werden an eine angegebene Trigger- oder Callback-Funktion übergeben. Der Zweck von Ereignisobjekten besteht darin, Informationen aus der clientseitigen Umgebung des Nutzers (z. B. Informationen, die er in den Widgets der Add-on-Oberfläche eingegeben hat) an den serverseitigen Code des Add-ons zu übergeben. Dieser kann dann auf diese Informationen reagieren und die entsprechende Antwort zurückgeben.

Weitere Informationen finden Sie unter Ereignisobjekte.

Gmail-Add-ons

Ein Add-on, das nur Gmail erweitert. Gmail-Add-ons sind kartenbasiert. Die meisten Funktionalitäts-, Verhaltens- und Entwicklungsdetails, die zum Erstellen von Gmail-Add-ons verwendet werden, sind mit den Details identisch, die zum Erstellen von Google Workspace-Add-ons verwendet werden.

Weitere Informationen finden Sie unter Gmail-Add-ons. Informationen dazu, wie Sie ein Gmail-Add-on in ein Google Workspace-Add-on konvertieren, finden Sie unter Veröffentlichte Add-ons aktualisieren.

Startseite

Die Stamm-UI-Karte eines Add-ons. Startseiten werden angezeigt, wenn Nutzer das Add-on öffnen. Das Add-on kann Inhalte außerhalb eines bestimmten Kontexts anzeigen, z. B. wenn der Nutzer seine E-Mail-Threads in Gmail ansieht, aber noch keine geöffnet hat. Aussehen und Verhalten der Add-on-Startseite legen Sie wie bei jeder anderen Karte fest.

Weitere Informationen finden Sie unter Startseiten.

Host- oder Host-Anwendung

Die Google Workspace-Anwendung, die durch ein Google Workspace-Add-on erweitert wird, z. B. Gmail oder Google Kalender.

HTML-basiert

Ein Add-on, dessen Benutzeroberfläche mit HTML und CSS anstelle des integrierten Apps Script-Kartendienstes definiert wird. Nur ältere Editor-Add-ons sind HTML-basiert.

Die Trigger für die Linkvorschau werden ausgelöst, wenn Nutzer in einer Google-Hostanwendung wie Google Docs mit einer Drittanbieter- oder Drittanbieter-URL interagieren. Mit Triggern für die Linkvorschau können Sie URL-Muster für die Vorschau aus Ihrem Dienst oder Ihrer API definieren und den Vorschauinhalt konfigurieren, einschließlich Smartchip und Vorschaukarte. Trigger für die Linkvorschau werden im Manifest des Add-on-Skriptprojekts konfiguriert und sind daher eine Art Manifest-Trigger.

Weitere Informationen finden Sie unter Vorschaulinks mit Smartchips.

Manifest

Eine JSON-Datei, die an ein Apps Script-Projekt angehängt ist. Mit dem Manifest werden Projektinformationen definiert, die für die korrekte Ausführung des Skripts erforderlich sind. Bei Google Workspace-Add-ons wird mit dem Manifest angegeben, welche Hosts durch das Add-on erweitert werden können. Außerdem werden damit bestimmte UI-Steuereinstellungen bereitgestellt.

Manifest trigger

Ein Trigger, der im Manifest eines Projekts definiert ist, z. B. ein Startseiten-Trigger oder kontextbezogener Trigger. Manifest-Trigger werden ausschließlich zum Erstellen und Anzeigen neuer Karten verwendet, wenn die Startseite eines Add-ons angefordert oder das Add-on in einen Kontext eintritt, in dem eine Aktualisierung der Anzeige erforderlich ist.

Manifest-Trigger unterscheiden sich von anderen Triggern in Apps Script, da sie nicht integriert sind (z. B. einfache Trigger) und mit dem Script-Dienst von Apps Script nicht programmatisch erstellt werden können (z. B. installierbare Trigger).

Karten ohne Kontext

Karten, die Inhalte anzeigen, wenn sich der Nutzer außerhalb eines bestimmten Kontexts befindet, z. B. wenn er sich seine E-Mail-Konversationen in Gmail ansieht, aber keine Konversation geöffnet hat. Startseiten sind eine Art von Karte, die keinen Kontext hat.

Der Bereich auf der rechten Seite der Host-UI, in dem die UI eines Google Workspace-Add-ons angezeigt wird. Mit den Add-ons für Gmail und Editoren lassen sich auch Seitenleisten definieren.

Smart chip

Ein Smartchip ist die Erwähnung einer Person, Datei, eines Kalendertermins oder einer anderen Entität in einer Google Workspace-Anwendung. Wenn Nutzer den Mauszeiger auf einen Chip bewegen, können sie sich auch zusätzliche Inhalte zur Datei oder zum Link in der Vorschau ansehen. Wenn Nutzer beispielsweise den Mauszeiger auf einen Chip in einer Google-Präsentation bewegen, sehen sie den Screenshot einer Folie, den Eigentümer der Präsentation und Informationen dazu, ob sie sich die Präsentation schon einmal angesehen haben.

Sie können das Add-on so konfigurieren, dass Smartchips verwendet werden, um sich eine Vorschau der Links für Dienste von Drittanbietern oder Drittanbietern anzeigen zu lassen. Weitere Informationen finden Sie unter Vorschaulinks in Google Docs.

Trigger

Eine Bedingung und eine automatische Ereignisantwort, die durch ein Apps Script-Projekt oder -Add-on definiert wurden. Trigger werden ausgelöst, wenn das zugehörige Ereignis eintritt (z. B. beim Öffnen eines Add-ons) und eine bestimmte Apps Script-Funktion (die Triggerfunktion) automatisch ausgeführt wird. Bei Google Workspace-Add-ons werden mit Triggerfunktionen häufig neue Karten erstellt, um zu steuern, welcher Teil der Add-on-UI angezeigt wird. Nur bestimmte Ereignistypen können Trigger haben.

Weitere Informationen finden Sie unter Add-on-Trigger.

Triggerfunktion

Eine Apps Script-Funktion in einem Projekt, die als Reaktion auf das Auslösen eines Triggers ausgeführt wird.

Widget

Ein UI-Element wie eine Schaltfläche, ein Textfeld oder ein Kästchen. Karten werden aus einer Reihe von Widget-Objekten erstellt, die durch den integrierten Kartendienst von Apps Script definiert werden.

Weitere Informationen finden Sie unter Widgets.

Widget-Handler-Funktion

Eine Funktion, die ein bestimmtes Widget mit einem bestimmten Aktionsobjekt verknüpft. Jeder Widget-Typ hat eine Reihe definierter Widget-Handler-Funktionen, mit denen eine Verbindung zu Aktionen hergestellt werden kann. Widget-Hander-Funktionen definieren, welche Art von Nutzerinteraktion die daraus resultierende Aktion auslöst. Sie sind eine wichtige Komponente der Widget-Interaktivität.

Weitere Informationen finden Sie unter Widget-Handler-Funktionen.