Glossar

In dieser Dokumentation werden die folgenden Begriffe verwendet.

Add-on für Videokonferenzen in Google Kalender

Eine spezielle Art von Add-on, mit dem Konferenzanbieter Konferenzoptionen in Google Kalender-Terminen präsentieren können. Für diese Add-ons ist eine gut entwickelte Konferenzlösung erforderlich, mit der das Add-on eine Verbindung herstellen kann. Aufgrund dieser Anforderung müssen die meisten Entwickler nie ein Add-on für Konferenzen in Google Kalender erstellen.

Weitere Informationen finden Sie unter Konferenz-Add-ons für Google Kalender. Informationen zum Umwandeln eines Konferenz-Add-ons für Google Kalender in ein Google Workspace-Add-on finden Sie unter Veröffentlichte Add-ons aktualisieren.

Infokarte

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

Weitere Informationen finden Sie unter Karten.

Kartenbasiert

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

Google Workspace-Add-ons sind kartenbasiert.

Konferenzdaten

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

Weitere Informationen finden Sie unter Konferenzdaten.

Konferenzlösung

Eine Darstellung einer Drittanbieterkonferenz, die über das Google Workspace-Add-on oder das Konferenz-Add-on für Google Kalender in Google Kalender erstellt werden kann.

Weitere Informationen finden Sie unter Konferenzlösungen.

Kontext

Der aktuelle Status der Hostanwendung. Zum Beispiel, welche Nachricht derzeit in Gmail geöffnet ist, welchen Kalendertermin Sie bearbeiten oder welche Drive-Dateien Sie ausgewählt haben, sind Teil des aktuellen Kontexts der Hostanwendung. Der Kontext wird zusammen mit anderen Informationen in einem Ereignisobjekt erfasst, das als Parameter an die Triggerfunktion übergeben wird.

Kontextabhängige Auslösung

Das Definieren von Triggern, die ausgelöst werden, wenn der Nutzer einen bestimmten Kontext betritt, z. B. wenn er einen E-Mail-Thread in Gmail öffnet. Mithilfe von kontextbezogenen Triggern kann Ihr Add-on eine für diesen Kontext relevante Benutzeroberfläche bereitstellen. Kontextbezogene Trigger werden im Manifest des Add-on-Scriptprojekts konfiguriert und sind somit eine Art Manifest-Trigger.

Editor-Add-ons

Die ursprünglichen Add-on-Typen, die nur Erweiterungen für Google Docs, Google Tabellen, Google Formulare oder Google Präsentationen zuließen. Editor-Add-ons sind nicht auf Karten basierend. Stattdessen mussten die Entwickler eine Benutzeroberfläche aus Roh-HTML und CSS 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, das Add-on Kontexte betritt, auf die es reagieren muss, oder als Ergebnis von Nutzerinteraktionen mit Widgets in der Add-on-Benutzeroberfläche. Nach der Erstellung werden Ereignisobjekte an eine angegebene Trigger- oder Rückruffunktion übergeben. Ereignisobjekte dienen dazu, Informationen aus der clientseitigen Umgebung des Nutzers (z. B. Informationen, die er in die Add-on-Benutzeroberflächen-Widgets eingegeben hat) an den serverseitigen Code des Add-ons zu übergeben, der dann auf diese Informationen reagieren und die entsprechende Antwort zurückgeben kann.

Weitere Informationen finden Sie unter Ereignisobjekte.

Gmail-Add-ons

Ein Add-on, das nur Gmail erweitert. Gmail-Add-ons sind kartenbasiert. Viele der Funktionen, Verhaltensweisen und Entwicklungsdetails, die beim Erstellen von Gmail-Add-ons verwendet werden, sind mit denen identisch, die beim Erstellen von Google Workspace-Add-ons verwendet werden.

Weitere Informationen finden Sie unter Gmail-Add-ons. Informationen zum Umwandeln eines Gmail-Add-ons in ein Google Workspace-Add-on 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. So kann Ihr Add-on Inhalte außerhalb eines bestimmten Kontexts anzeigen, z. B. wenn sich der Nutzer seine E-Mail-Unterhaltungen in Gmail ansieht, aber keine davon geöffnet hat. Aussehen und Verhalten der Add-on-Startseite definieren Sie wie bei jeder anderen Karte.

Weitere Informationen finden Sie unter Startseiten.

Host oder Hostanwendung

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 statt mit dem integrierten Kartendienst von App Script definiert ist. Nur ältere Editor-Add-ons sind HTML-basiert.

Die Linkvorschau wird ausgelöst, wenn Nutzer in einer Google-Hostanwendung wie Google Docs mit einer Drittanbieter-URL oder einer URL von einem anderen Anbieter interagieren. Mit dem Trigger für die Linkvorschau können Sie URL-Muster für die Vorschau aus Ihrem Dienst oder Ihrer API definieren und die Vorschauinhalte konfigurieren, einschließlich des Smartchips und der Vorschaukarte. Trigger für Linkvorschau werden im Manifest des Add-on-Scriptprojekts konfiguriert und sind somit eine Art Manifesttrigger.

Weitere Informationen finden Sie unter Vorschaulinks mit Smartchips erstellen.

Manifest

Eine JSON-Datei, die an ein Apps Script-Projekt angehängt ist. Im Manifest werden Projektinformationen definiert, die für die korrekte Ausführung des Scripts erforderlich sind. Bei Google Workspace-Add-ons wird im Manifest angegeben, welche Hosts das Add-on erweitern kann, und es werden bestimmte Einstellungen für die Benutzeroberfläche festgelegt.

Manifest-Trigger

Ein Trigger, der im Manifest eines Projekts definiert ist, z. B. ein Startseiten- oder Kontexttrigger. Manifest-Trigger werden ausschließlich zum Erstellen und Anzeigen neuer Karten verwendet, wenn eine Add-on-Startseite angefordert wird oder das Add-on einen Kontext aufruft, der eine Aktualisierung der Anzeige erfordert.

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

Nicht kontextbezogene Karten

Karten, die Inhalte anzeigen, wenn sich der Nutzer nicht in einem bestimmten Kontext befindet, z. B. wenn er sich seine E-Mail-Unterhaltungen in Gmail ansieht, aber keine davon geöffnet hat. Startseiten sind eine Art nicht kontextbezogener Karte.

Der Bereich rechts neben der Host-Benutzeroberfläche, in dem die Benutzeroberfläche eines Google Workspace-Add-ons angezeigt wird. Seitenleisten können auch über Gmail- und Editor-Add-ons definiert werden.

Smart chip

Ein Smartchip ist eine 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 eine Vorschau weiterer Inhalte zur Datei oder zum Link ansehen. Wenn Nutzer beispielsweise den Mauszeiger auf einen Chip zu einer Google Präsentation bewegen, sehen sie einen Screenshot einer Folie, den Inhaber der Präsentation und ob sie sich die Präsentation schon einmal angesehen haben.

Sie können Ihr Add-on so konfigurieren, dass Smartchips verwendet werden, um Links für einen Drittanbieter- oder einen anderen Dienst als Google in der Vorschau anzuzeigen. Weitere Informationen

Trigger

Eine Bedingung und eine automatische Ereignisantwort, die in einem Apps Script-Projekt oder Add-on definiert sind. Trigger werden ausgelöst, wenn das zugehörige Ereignis eintritt (z. B. wenn ein Add-on geöffnet wird). Dadurch wird automatisch eine angegebene Apps Script-Funktion (die Triggerfunktion) ausgeführt. Bei Google Workspace-Add-ons werden mit Triggerfunktionen häufig neue Karten erstellt, um zu steuern, welcher Teil der Add-on-Benutzeroberfläche 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 einen ausgelösten Trigger ausgeführt wird.

Widget

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

Weitere Informationen finden Sie unter Widgets.

Widget-Handlerfunktion

Eine Funktion, die ein bestimmtes Widget mit einem bestimmten Aktionsobjekt verknüpft. Für jeden Widget-Typ gibt es eine Reihe von definierten Widget-Handler-Funktionen, mit denen eine Verbindung zu Aktionen hergestellt werden kann. Mit Widget-Handler-Funktionen wird festgelegt, welche Art von Nutzerinteraktion die resultierende Aktion auslöst. Sie sind eine wichtige Komponente der Widget-Interaktivität.

Weitere Informationen finden Sie unter Widget-Handlerfunktionen.