Google Tabellen mit Add-ons erweitern

Google Tabellen ist eine cloudbasierte Tabellenlösung mit 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, die Verbindung zu Drittanbietersystemen herzustellen und Ihre Google Tabellen-Daten in andere Google Workspace-Anwendungen wie Google Präsentationen einzubinden.

Sie können sich die Add-ons für Google Tabellen ansehen, die andere Nutzer im Google Workspace Marketplace erstellt haben.

Das können Sie tun

Mit einem Add-on für Google Tabellen haben Sie unter anderem folgende Möglichkeiten:

Add-ons für Tabellen werden mit Apps Script erstellt. Weitere Informationen zum Aufrufen und Verwalten von Google Tabellen mit Apps Script finden Sie unter Google Tabellen erweitern.

Struktur des Tabellenblatts

Eine Tabelle in Google Tabellen besteht aus einem oder mehreren Tabellenblättern. Jedes Tabellenblatt besteht im Wesentlichen aus einem 2D-Raster von Zellen, in denen Text, Zahlen, Links oder andere Werte gespeichert werden können. Eine Gruppe aus einer oder mehreren benachbarten Zellen wird als Bereich bezeichnet.

Der Tabellendienst von Apps Script bietet mehrere Klassen zur Darstellung von Organisationsstrukturen in Google Tabellen (z. B. Sheet und Range). Sie können diese Klassen verwenden, um Daten und das Verhalten in Google Tabellen zu lesen und zu ändern.

Trigger

Mit Apps Script-Triggern kann ein Skriptprojekt 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 Tabellen-Add-ons verwendet werden können und welche Einschränkungen für ihre Verwendung gelten, finden Sie unter Add-on-Trigger.

Benutzerdefinierte Funktionen

Google Tabellen bietet eine Reihe von integrierten Funktionen wie SUM und AVERAGE, die von einer Zelle in Google Tabellen aus aufgerufen werden können. Add-ons für Tabellen können zusätzliche benutzerdefinierte Funktionen definieren, um diese integrierten Funktionen zu ergänzen. Wenn ein Nutzer das Add-on installiert, sind alle darin enthaltenen benutzerdefinierten Funktionen sofort verfügbar. Ein Add-on kann nur aus Definitionen für benutzerdefinierte Funktionen bestehen. Definitionen benutzerdefinierter Funktionen werden in erster Linie für andere Nutzer freigegeben, indem ein Add-on mit den Definitionen veröffentlicht wird.

Benutzerdefinierte Add-on-Funktionen erstellen

Jede in einem Add-on-Skriptprojekt definierte Funktion 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 Tabellen-Funktion aufrufen: Geben Sie in einer Tabellenzelle =, gefolgt vom Namen der Funktion und erforderlichen Parametern ein. Wenn keine Fehler vorhanden sind, wird das von der Funktion zurückgegebene Ergebnis in die Tabellenblatt-Zelle verschoben und bei Bedarf in die benachbarten Zellen übertragen.

Beachten Sie beim Erstellen benutzerdefinierter Funktionen in einem Add-on die allgemeinen Richtlinien für benutzerdefinierte Funktionen:

Darüber hinaus sind für benutzerdefinierte Funktionen, die in Add-ons definiert sind, einige Besonderheiten zu beachten:

  • Versuchen Sie, der Funktion einen eindeutigen Namen zu geben, der sich möglicherweise auf den Namen Ihres Add-ons bezieht. Wenn zwei oder mehr installierte Add-ons benutzerdefinierte Funktionen mit demselben Namen definieren, können Nutzer nur eine davon verwenden.
  • Ihr Add-on sollte klar kommunizieren, welche benutzerdefinierten Funktionen es bietet. Achten Sie darauf, korrekte JSDoc-Kommentare für Ihre benutzerdefinierten Funktionen anzugeben, damit Apps Script dem Nutzer Informationen zur automatischen Vervollständigung präsentieren kann. Wir empfehlen außerdem, zusätzliche Dokumentation für die benutzerdefinierten Funktionen entweder im Add-on selbst oder auf einer Supportwebseite für das Add-on bereitzustellen.
  • Benutzerdefinierte Funktionen, die nicht in weniger als 30 Sekunden ausgeführt werden, schlagen mit dem Fehler Internal error executing the custom function fehl. Sorgen Sie für eine gute Nutzererfahrung, indem Sie den Verarbeitungsaufwand 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 an die Apps Script-Server. Wenn ein Nutzer versucht, benutzerdefinierte Funktionen in zu vielen Zellen zu verwenden, werden die Funktionen möglicherweise langsam ausgeführt. Halten Sie Ihre benutzerdefinierten Funktionen so einfach wie möglich, um dieses Risiko zu minimieren. Wenn Sie mit der Funktion komplexe oder erweiterte Verarbeitungen ausführen möchten, sollten Sie keine benutzerdefinierte Funktion verwenden. Stellen Sie diese Funktion stattdessen über einen Menüpunkt, ein Dialogfeld oder eine Interaktion in der Seitenleiste bereit.

Makros in Google Tabellen

Mit Makros können Sie Aktionen in Google Tabellen aufzeichnen und später mit einer Tastenkombination wiederholen. Wenn ein Makro in einem Tabellenblatt erstellt wird, wird es in einem Apps Script-Projekt als Makrofunktion hinzugefügt, die an dieses Tabellenblatt gebunden ist. Weitere Informationen zu Makros finden Sie unter Google Tabellen-Makros.

Leider können Google Tabellen-Makros 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.