Glossar

In dieser Dokumentation werden die folgenden Begriffe verwendet.

Add‑on für Videokonferenzen in Google Kalender

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

Weitere Informationen finden Sie unter Konferenz-Add-ons für Google Kalender. Weitere Informationen zum Umwandeln eines Kalender-Konferenz-Add-ons 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 (oder auf Mobilgeräten als weiteres Aktivitätsfenster, das über das Menü aufgerufen wird) angezeigt wird. Das Add-on hat eine obere Symbolleiste, in der das Add-on identifiziert wird und eine Karte angezeigt wird. Eine Karte ist 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 von einem Google Workspace-Add-on oder einem Kalender-Videokonferenz-Add-on unterstützte Videokonferenzen von Drittanbietern erstellen und daran teilnehmen können.

Weitere Informationen finden Sie unter Konferenzdaten.

Konferenzlösung

Eine Darstellung einer Drittanbieterkonferenz, die über ein Google Workspace-Add-on oder ein Kalender-Videokonferenz-Add-on in Google Kalender erstellt werden kann.

Weitere Informationen finden Sie unter Konferenzlösungen.

Kontext

Der aktuelle Status der Hostanwendung. Zum Beispiel, welche Nachricht gerade 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.

Kontextbezogene Auslösung

Das Definieren von Triggern, die ausgelöst werden, wenn der Nutzer einen bestimmten Kontext aufruft, z. B. wenn er einen E‑Mail-Thread in Gmail öffnet. Durch kontextbezogenes Auslösen kann Ihr Add-on eine Benutzeroberfläche bereitstellen, die für den jeweiligen Kontext relevant ist. Kontextbezogene Trigger werden im Manifest des Add-on-Scriptprojekts konfiguriert und sind daher eine Art Manifest-Trigger.

Editor-Add-ons

Die ursprüngliche Gruppe von Add‑on-Typen, die nur Erweiterungen von Google Docs, Google Sheets, Google Formulare oder Google Präsentationen zuließen. Editor-Add-ons sind nicht kartenbasiert. Stattdessen musste der Entwickler eine Benutzeroberfläche aus rohem 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, wenn das Add-on in Kontexte eintritt, auf die es reagieren muss, oder als Ergebnis von Nutzerinteraktionen mit Widgets in der Add-on-Oberfläche. Nach der Erstellung werden Ereignisobjekte an eine angegebene Triggerfunktion oder Callback-Funktion übergeben. Mit Ereignisobjekten werden Informationen aus der clientseitigen Umgebung des Nutzers (z. B. Informationen, die er in die Add-on-Oberflächen-Widgets eingegeben hat) an den serverseitigen Code des Add-ons ü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. Viele der Funktionen, Verhaltensweisen und Entwicklungsdetails, die zum Erstellen von Gmail-Add-ons verwendet werden, sind identisch mit denen, die zum Erstellen von Google Workspace-Add-ons verwendet werden.

Weitere Informationen zu Gmail-Add-ons Weitere Informationen zum Konvertieren eines Gmail-Add‑ons in ein Google Workspace-Add‑on finden Sie unter Veröffentlichte Add‑ons upgraden.

Startseite

Die Stamm-UI-Karte eines Add-ons. Startseiten werden angezeigt, wenn Nutzer das Add-on öffnen. So können Sie Inhalte außerhalb eines bestimmten Kontexts präsentieren, z. B. wenn der Nutzer seine E-Mail-Konversationen in Gmail aufruft, aber noch keine geöffnet hat. Sie definieren das Erscheinungsbild und das Verhalten der Add-on-Startseite 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 anstelle des integrierten Card-Diensts von Apps Script definiert wird. Nur ältere Editor-Add-ons basieren auf HTML.

Linkvorschau-Trigger werden ausgelöst, wenn Nutzer in einer Google-Hostanwendung wie Google Docs mit einer Drittanbieter- oder Nicht-Google-URL interagieren. Mit der Linkvorschau-Auslösung können Sie URL-Muster definieren, die in Ihrem Dienst oder Ihrer API in der Vorschau angezeigt werden sollen, und die Vorschauinhalte konfigurieren, einschließlich des Smart-Chips und der Vorschaukarte. Link-Vorschaueinblendungen 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. Im Manifest werden Projektinformationen definiert, die für die korrekte Ausführung des Skripts erforderlich sind. Bei Google Workspace-Add-ons wird das Manifest verwendet, um anzugeben, welche Hosts das Add-on erweitern kann, und um bestimmte Einstellungen für die Benutzeroberfläche bereitzustellen.

Manifest-Trigger

Ein Trigger, der im Manifest eines Projekts definiert ist, z. B. ein Homepage- oder Kontext-Trigger. Manifest-Trigger werden ausschließlich verwendet, um neue Karten zu erstellen und anzuzeigen, wenn die Add-on-Startseite aufgerufen wird oder das Add-on in einen Kontext wechselt, der eine Aktualisierung der Anzeige erfordert.

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

Nicht kontextbezogene Karten

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

Der Bereich auf der rechten Seite der Host-Benutzeroberfläche, in dem die Benutzeroberfläche eines Google Workspace-Add-ons angezeigt wird. Gmail- und Editor-Add-ons können auch Seitenleisten definieren.

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 mit zusätzlichen Informationen zur Datei oder zum Link ansehen. Wenn Nutzer beispielsweise den Mauszeiger auf einen Chip für eine Google-Präsentation bewegen, sehen sie einen Screenshot einer Folie, den Inhaber der Präsentation und ob sie die Präsentation schon einmal angesehen haben.

Sie können Ihr Add-on so konfigurieren, dass Smart Chips verwendet werden, um Links für einen Drittanbieterdienst oder einen Dienst, der nicht von Google stammt, in der Vorschau anzuzeigen. Weitere Informationen

Trigger

Eine Bedingung und automatische Ereignisreaktion, die durch ein Apps Script-Projekt oder ‑Add-on definiert wird. Trigger werden ausgelöst, wenn das zugehörige Ereignis eintritt (z. B. wenn ein Add-on geöffnet wird). Dadurch wird automatisch eine bestimmte Apps Script-Funktion (die Triggerfunktion) ausgeführt. Bei Google Workspace-Add-ons werden mit Triggerfunktionen oft 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.

Funktion auslösen

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 vom integrierten Card-Dienst 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. Für jeden Widget-Typ gibt es eine Reihe definierter Widget-Handler-Funktionen, mit denen eine Verbindung zu Aktionen hergestellt werden kann. Widget-Handler-Funktionen definieren, welche Art von Nutzerinteraktion die resultierende Aktion auslöst. Sie sind ein wichtiger Bestandteil der Widget-Interaktivität.

Weitere Informationen finden Sie unter Widget-Handler-Funktionen.