Google Sheets mit Add-ons erweitern

Google Tabellen ist eine cloudbasierte Tabellenkalkulationslösung mit Funktionen für die Zusammenarbeit in Echtzeit und leistungsstarken Tools zum Visualisieren, Verarbeiten und Kommunizieren von Daten.

Sie können Google Tabellen mit Add‑ons erweitern, um benutzerdefinierte Workflow-Verbesserungen zu erstellen, Verbindungen zu Drittanbietersystemen herzustellen und Ihre Google Tabellen-Daten in andere Google Workspace-Anwendungen (z. B. Google Präsentationen) einzubinden.

Im Google Workspace Marketplace finden Sie Tabellen-Add‑ons, die von anderen entwickelt wurden.

Maßnahmen

Hier sind einige Beispiele für Add-ons, mit denen Sie Google Tabellen erweitern können:

Sheets-Add-ons werden mit Apps Script erstellt. Weitere Informationen zum Zugriff auf und zur Verwaltung von Google Tabellen mit Apps Script finden Sie unter Google Tabellen erweitern.

Tabellenblattstruktur

Eine Google-Tabelle besteht aus einem oder mehreren Tabellenblättern. Jedes Tabellenblatt ist im Grunde ein zweidimensionales Raster aus Zellen, in denen Text, Zahlen, Links oder andere Werte gespeichert werden können. Eine Gruppe von einer oder mehreren angrenzenden Zellen wird als Bereich bezeichnet.

Der Apps Script-Tabellendienst bietet mehrere Klassen zur Darstellung von Organisationsstrukturen in Google Tabellen, z. B. Sheet und Range. Mit diesen Klassen können Sie Daten und Verhalten in Google Tabellen lesen und ändern.

Trigger

Mit Apps Script-Triggern kann ein Scriptprojekt eine bestimmte Funktion ausführen, wenn bestimmte Bedingungen erfüllt sind, z. B. wenn eine Tabelle geöffnet oder ein Add‑on installiert wird.

Weitere Informationen dazu, welche Trigger mit Google Sheets-Add-ons verwendet werden können und welche Einschränkungen für ihre Verwendung gelten, finden Sie unter Add-on-Trigger.

Benutzerdefinierte Funktionen

Sheets bietet eine Reihe von integrierten Funktionen wie SUM und AVERAGE, die aus einer Sheets-Zelle aufgerufen werden können. Mit Google Sheets-Add-ons können zusätzliche benutzerdefinierte Funktionen definiert werden, um diese integrierten Funktionen zu ergänzen. Wenn ein Nutzer das Add-on installiert, sind alle benutzerdefinierten Funktionen, die im Add-on enthalten sind, sofort verfügbar. Ein Add-on kann nur aus benutzerdefinierten Funktionsdefinitionen bestehen. Benutzerdefinierte Funktionsdefinitionen werden hauptsächlich mit anderen geteilt, indem ein Add-on mit den Definitionen veröffentlicht wird.

Benutzerdefinierte Add-on-Funktionen erstellen

Jede Funktion, die in einem Add-on-Scriptprojekt definiert ist, kann als benutzerdefinierte Funktion verwendet werden. Sobald die Funktion implementiert und das Add-on installiert ist, können Sie die benutzerdefinierte Funktion wie jede andere integrierte Google Sheets-Funktion aufrufen: Geben Sie in eine Tabellenzelle das = gefolgt vom Namen der Funktion und allen erforderlichen Parametern ein. Wenn keine Fehler vorhanden sind, wird das von der Funktion zurückgegebene Ergebnis in die Google-Tabellen-Zelle eingefügt und bei Bedarf auf benachbarte Zellen übertragen.

Wenn Sie benutzerdefinierte Funktionen in einem Add-on erstellen, sollten Sie die allgemeinen Richtlinien für benutzerdefinierte Funktionen beachten:

Außerdem gelten für benutzerdefinierte Funktionen, die in Add-ons definiert sind, einige Besonderheiten:

  • Wählen Sie für Ihre Funktion einen eindeutigen Namen, der sich vielleicht auf den Namen Ihres Add-ons bezieht. Wenn in zwei oder mehr installierten Add-ons benutzerdefinierte Funktionen mit demselben Namen definiert sind, können Nutzer nur eine davon verwenden.
  • In Ihrem Add-on sollte klar angegeben sein, welche benutzerdefinierten Funktionen es bietet. Achten Sie darauf, dass Sie für Ihre benutzerdefinierten Funktionen genaue JSDoc-Kommentare angeben, damit Apps Script dem Nutzer Informationen zur automatischen Vervollständigung präsentieren kann. Außerdem sollten Sie zusätzliche Dokumentation der benutzerdefinierten Funktionen entweder im Add-on selbst oder auf einer Support-Webseite für Add-ons bereitstellen.
  • Benutzerdefinierte Funktionen, die nicht innerhalb von 30 Sekunden abgeschlossen werden, schlagen mit einem Internal error executing the custom function-Fehler fehl. Sorgen Sie für eine gute Nutzererfahrung, indem Sie die Menge der Verarbeitung in einer benutzerdefinierten Funktion begrenzen. Optimieren Sie die Funktion, wo immer möglich.
  • Benutzerdefinierte Funktionen können keine Apps Script-Dienste verwenden, für die eine Autorisierung erforderlich ist. In diesem Fall schlagen sie mit dem Fehler You do not have permission to call X service fehl. Verwenden Sie in Ihrer benutzerdefinierten Funktion nur die zulässigen Dienste.
  • Jede benutzerdefinierte Funktion in Google Sheets führt zu einem separaten Aufruf der Apps Script-Server. Wenn ein Nutzer versucht, benutzerdefinierte Funktionen in zu vielen Zellen zu verwenden, kann die Ausführung der Funktionen langsam sein. Um dieses Problem zu vermeiden, sollten Sie Ihre benutzerdefinierten Funktionen so einfach wie möglich halten. Wenn die Funktion eine komplexe oder erweiterte Verarbeitung ausführen soll, verwenden Sie keine benutzerdefinierte Funktion, sondern stellen Sie diese Funktion stattdessen über ein Menüelement, ein Dialogfeld oder eine Seitenleisteninteraktion bereit.

Sheets-Makros

Mit Makros können Sie Aktionen aufzeichnen, die in Google Sheets ausgeführt werden, und sie später mit einem Tastenkürzel wiederholen. Wenn ein Makro in einem Google-Tabellen-Dokument erstellt wird, wird es als Makrofunktion in einem Apps Script-Projekt hinzugefügt, das an dieses Google-Tabellen-Dokument gebunden ist. Weitere Informationen zu Makros finden Sie unter Sheets-Makros.

Sheets-Makros können leider nicht mit Add-ons verteilt werden. Wenn Sie eine Makrodefinition in das Manifest eines Add-ons aufnehmen, ist sie für Nutzer dieses Add-ons nicht verfügbar.