Google Tabellen mit Add-ons erweitern

Google Tabellen ist eine cloudbasierte Tabellenlösung mit Echtzeit-Zusammenarbeit und leistungsstarken Tools zur Visualisierung, Verarbeitung und Kommunikation von Daten.

Sie können Google Tabellen mit Add-ons erweitern, um benutzerdefinierte Workflow-Verbesserungen zu erstellen, eine Verbindung zu Drittanbietersystemen herzustellen und Ihre Tabellendaten in andere Google Workspace-Anwendungen wie Google Präsentationen einzubinden.

Die von anderen erstellten Add-ons für Google Tabellen finden Sie im Google Workspace Marketplace.

Maßnahmen

Mit einem Add-on, das Google Tabellen erweitert, haben Sie folgende Möglichkeiten:

• Mit dem integrierten Apps Script-Tabellendienst können Sie Daten in Google Tabellen lesen, bearbeiten, visualisieren und formatieren. Außerdem können Sie mit dem Dienst Regeln für die bedingte Formatierung und Datenvalidierung erstellen und ändern.
• Sie können den erweiterten Google Tabellen-Dienst von Apps Script verwenden, um direkt auf die Google Sheets API zuzugreifen.
• Mit Standard-HTML und -CSS können Sie benutzerdefinierte Menüs erstellen und mehrere benutzerdefinierte Dialogfelder und Seitenleisten definieren.
• Sie können Definitionen für benutzerdefinierte Funktionen in Ihr Add-on aufnehmen.
• Sie können Add-on-Trigger verwenden, die bestimmte Funktionen ausführen, wenn bestimmte Triggerereignisse auftreten.

Google Tabellen-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.

Tabellenstruktur

Eine Google Tabellen-Tabelle besteht aus einem oder mehreren Arbeitsblättern. Jedes Tabellenblatt ist im Grunde ein 2D-Raster aus Zellen, in denen Text, Zahlen, Links oder andere Werte gespeichert werden können. Eine Gruppe von einer oder mehreren benachbarten 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 Google Tabellen-Daten und das Verhalten von Google Tabellen lesen und ändern.

Trigger

Mit Auslösern in Apps Script kann in einem Scriptprojekt eine bestimmte Funktion ausgeführt werden, 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 Tabellen-Add-ons verwendet werden können und welche Einschränkungen gelten, finden Sie unter Add-on-Trigger.

Benutzerdefinierte Funktionen

Google Tabellen bietet eine Reihe von vordefinierten Funktionen wie SUM und AVERAGE, die in einer Google Tabellenzelle aufgerufen werden können. Mit Google Tabellen-Add-ons können Sie zusätzliche benutzerdefinierte Funktionen definieren, um diese vordefinierten 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 benutzerdefinierter Funktionen bestehen. Definitionen für benutzerdefinierte Funktionen werden in erster Linie durch die Veröffentlichung eines Add-ons mit den Definitionen für andere freigegeben.

Benutzerdefinierte Funktionen für Add-ons erstellen

Jede in einem Add-on-Scriptprojekt 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 eine Tabellenzelle = gefolgt vom Namen der Funktion und allen erforderlichen Parametern ein. Wenn keine Fehler auftreten, wird das von der Funktion zurückgegebene Ergebnis in die Zelle der Tabelle eingefügt und bei Bedarf in benachbarte Zellen überlaufen.

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

• Richtlinien für die Benennung von Funktionen
• Funktionsargumente definieren
• Rückgabewert der Funktion definieren
• Datentypen für benutzerdefinierte Funktionen
• Automatische Vervollständigung mit JSDoc aktivieren
• Dienste, die von benutzerdefinierten Funktionen verwendet werden können
• Benutzerdefinierte Funktionen optimieren

Bei benutzerdefinierten Funktionen, die in Add-ons definiert sind, sind außerdem einige Besonderheiten zu beachten:

• Achten Sie darauf, dass der Name Ihrer Funktion eindeutig ist und sich gegebenenfalls 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 Autocomplete-Informationen präsentieren kann. Sie können auch zusätzliche Dokumentationen zu den 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. Begrenzen Sie die Verarbeitung in einer benutzerdefinierten Funktion, um die Nutzerfreundlichkeit zu verbessern. Optimieren Sie die Funktion nach Möglichkeit.
• Für benutzerdefinierte Funktionen können keine Apps Script-Dienste verwendet werden, für die eine Autorisierung erforderlich ist. Bei einem solchen Versuch 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 sie möglicherweise langsam ausgeführt. Um dies 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. Bieten Sie diese Funktion stattdessen über einen Menüpunkt, ein Dialogfeld oder eine Interaktion in der Seitenleiste an.

Tabellenmakros

Mit Makros können Sie Aktionen in Google Tabellen aufzeichnen und 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 mit dieser Tabelle verknüpft ist. Weitere Informationen zu Makros finden Sie unter Makros in Google Tabellen.

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