Google Tabellen 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 wie Google Präsentationen einzubinden.

Im Google Workspace Marketplace finden Sie die von anderen entwickelten Google Tabellen-Add‑ons.

Maßnahmen

Hier sind einige Beispiele für die Möglichkeiten, die sich durch ein Add-on ergeben, das Google Tabellen erweitert:

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-Tabellenkalkulation 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 Tabellendaten und ‑verhalten 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

Google Sheets bietet eine Reihe von integrierten Funktionen wie SUM und AVERAGE, die aus einer Google-Tabellenzelle aufgerufen werden können. In Google Tabellen-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 = gefolgt vom Namen der Funktion und allen erforderlichen Parametern ein. Wenn keine Fehler vorhanden sind, wird das von der Funktion zurückgegebene Ergebnis in der Tabellenzelle platziert und bei Bedarf in 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 besondere Überlegungen:

  • 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 werden, welche benutzerdefinierten Funktionen es bietet. Achten Sie darauf, dass Sie für Ihre benutzerdefinierten Funktionen korrekte 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 das Add-on 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 wird der Fehler You do not have permission to call X service ausgegeben. Verwenden Sie in Ihrer benutzerdefinierten Funktion nur die zulässigen Dienste.
  • Jede benutzerdefinierte Funktion in einem Tabellenblatt führt zu einem separaten Aufruf der Apps Script-Server. Wenn ein Nutzer versucht, benutzerdefinierte Funktionen in zu vielen Zellen zu verwenden, werden die Funktionen möglicherweise langsam ausgeführt. Um dieses Problem zu vermeiden, sollten Sie Ihre benutzerdefinierten Funktionen so einfach wie möglich halten. Wenn die Funktion komplexe oder erweiterte Verarbeitungsschritte 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 einer Tastenkombination wiederholen. Wenn ein Makro in einer Tabelle erstellt wird, wird es als Makrofunktion in einem Apps Script-Projekt hinzugefügt, das an diese Tabelle gebunden ist. Weitere Informationen zu Makros finden Sie unter Google 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.