Kartenbasierte Oberflächen

Google Workspace-Add‑ons sind kartenbasiert. Editor-Add-ons basieren auf HTML.

Beispiel für eine Google Workspace-Add‑on-Kartenoberfläche.

Add-ons präsentieren Informationen und Nutzereinstellungen in der Seitenleiste der Benutzeroberfläche der Hostanwendung. Ein Google Workspace-Add-on besteht aus einer Hauptsymbolleiste zur Identifizierung und einer oder mehreren Karten.

Jede Karte stellt eine bestimmte „Seite“ der Add-on-Benutzeroberfläche dar. Zu einer neuen Karte wechseln ist in der Regel so einfach wie das Erstellen der Karte und das Übertragen auf einen internen Kartenstapel. Sie können Navigationsabläufe zwischen Karten definieren, um eine umfassende Interaktion zu ermöglichen.

Karten können nicht kontextbezogen oder kontextbezogen sein. Kontextbezogene Karten werden dem Nutzer angezeigt, wenn sich die Hostanwendung in einem bestimmten Kontext befindet, z. B. beim Öffnen einer Gmail-Nachricht oder eines Google Kalender-Termins. Nicht kontextbezogene Karten (z. B. Startseiten) werden dem Nutzer außerhalb eines bestimmten Kontexts des Hosts präsentiert, z. B. wenn der Nutzer seinen Gmail-Posteingang, seinen Hauptordner in Google Drive oder seinen Kalender aufruft.

Google Workspace-Add‑ons, die in Google Apps Script erstellt wurden, verwenden den Card-Dienst, um Benutzeroberflächen aus Karten zu erstellen. Add-ons, die in anderen Sprachen erstellt wurden, müssen korrekt formatiertes JSON zurückgeben, damit die Benutzeroberfläche als Karten gerendert werden kann.

Jede Karte besteht aus einem Header und einem oder mehreren Kartenabschnitten. Jeder Bereich besteht aus einer Reihe von Widgets. Widgets zeigen dem Nutzer Informationen an oder bieten Interaktionssteuerelemente wie Schaltflächen.

Kartenbasierte Benutzeroberflächen haben folgende Vorteile:

  • Sie benötigen keine HTML- oder CSS-Kenntnisse, um kartenbasierte Benutzeroberflächen zu erstellen.
  • Karten und Widgets werden automatisch so gestaltet, dass sie gut mit den Google Workspace-Anwendungen zusammenarbeiten, die sie erweitern.
  • Kartenbasierte Oberflächen funktionieren sowohl auf Computern als auch auf Mobilgeräten. Sie müssen die Oberfläche aber nur einmal definieren.

Gmail ist die einzige Hostanwendung, die auf Mobilgeräten durch Google Workspace-Add-ons erweitert werden kann.

Kartenbasierte Benutzeroberflächen erstellen

Beim Erstellen kartenbasierter Add-ons ist es wichtig, bestimmte Konzepte und Designmuster zu verstehen. In den folgenden Leitfäden finden Sie die Informationen, die Sie zum Erstellen effektiver kartenbasierter Add-ons benötigen:

Diese Seiten können Ihnen beim Erstellen von Karten und Implementieren des UI-Verhaltens helfen. Die folgenden zusätzlichen Beispiele können bei der Implementierung Ihres Add-ons hilfreich sein:

  • Google Workspace-Add-on „Cats“ – Kurzanleitung

    In diesem Add-on-Beispiel wird eine Add-on-Benutzeroberfläche mit mehreren Seiten und Startseiten gezeigt.

  • Google Workspace-Add-on: „Übersetzen“

    In diesem Add-on-Beispiel wird ein Add-on gezeigt, mit dem Nutzer Text in Google Docs, Google Sheets und Google Präsentationen übersetzen können.

  • Google Workspace-Add-on: „Teams List“

    Dieses Add-on-Beispiel zeigt ein komplexeres Google Workspace-Add-on-Beispiel, das Nutzerinformationen zu Empfängern von Gmail-Nachrichten, Bearbeitern von Drive-Dateien oder Teilnehmern von Kalenderterminen enthält. Sie können dieses Add-on nur innerhalb einer Domain verwenden, da es die Directory API zum Abrufen von Nutzerinformationen verwendet.