Google Sheets mit Add-ons erweitern

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

Sie können Sheets mit Add-ons erweitern, die benutzerdefinierte Workflowverbesserungen ermöglichen, eine Verbindung zu Drittanbietersystemen herstellen und Ihre Sheets-Daten in andere Google Workspace-Anwendungen (z. B. Google Präsentationen) einbinden.

Im Google Workspace Marketplace finden Sie die von anderen Nutzern erstellten Sheets-Add-ons.

Maßnahmen

Hier einige Beispiele für die Möglichkeiten, die Ihnen Add-ons zur Erweiterung von Sheets bieten:

• Mit dem integrierten Apps Script Tabellendienst können Sie Daten in Google Sheets-Tabellen lesen, bearbeiten, visualisieren und formatieren. Mit dem Dienst lassen sich auch Regeln für die bedingte Formatierung und Datenvalidierung erstellen und ändern.
• Mit dem Apps Script erweiterten Tabellendienst können Sie direkt auf die Google Sheets API zugreifen.
• Sie können benutzerdefinierte Menüs erstellen und mehrere benutzerdefinierte Dialogfelder und Seitenleisten Oberflächen mit Standard-HTML und CSS definieren.
• Sie können benutzerdefinierte Funktionsdefinitionen in Ihr Add-on einfügen.
• Sie können Add-on-Trigger verwenden, mit denen bestimmte Funktionen ausgeführt werden, wenn bestimmte Triggerereignisse eintreten.

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

Tabellenstruktur

Eine Google Sheets-Tabelle besteht aus einem oder mehreren Tabellenblättern. Jedes Tabellenblatt ist im Wesentlichen ein 2D-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 Sheets (z. B. Sheet und Range). Mit diesen Klassen können Sie Sheets-Daten und -Verhalten lesen und ändern.

Trigger

Mit Apps Script-Triggern kann ein Skript projekt 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 zu den Triggern, die mit Sheets Add-ons verwendet werden können, und zu den Einschränkungen bei ihrer Verwendung finden Sie unter Add-on-Trigger.

Benutzerdefinierte Funktionen

Sheets bietet eine Reihe integrierter Funktionen wie SUM und AVERAGE, die aus einer Sheets-Zelle aufgerufen werden können. Sheets-Add-ons können zusätzliche benutzerdefinierte Funktionen definieren, um diese integrierten Funktionen zu ergänzen. Wenn ein Nutzer das Add-on installiert, sind alle definierten benutzerdefinierten Funktionen, die im Add-on enthalten sind, sofort verfügbar. Ein Add-on kann auch nur aus benutzerdefinierten Funktionsdefinitionen bestehen. Benutzerdefinierte Funktionsdefinitionen werden hauptsächlich für andere freigegeben, indem ein Add-on veröffentlicht wird, das die Definitionen enthält.

Benutzerdefinierte Funktionen für Add-ons erstellen

Jede Funktion, die in einem Add-on-Skriptprojekt 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 Sheets-Funktion aufrufen: Geben Sie in einer Tabellenzelle = gefolgt vom Namen der Funktion und allen erforderlichen Parametern ein. Wenn keine Fehler auftreten, wird das von der Funktion zurückgegebene Ergebnis in der Sheets-Zelle platziert und bei Bedarf auf benachbarte Zellen übertragen.

Beim Erstellen benutzerdefinierter Funktionen in einem Add-on sollten Sie die allgemeinen Richtlinien für benutzerdefinierte Funktionen beachten:

• 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

Darüber hinaus gibt es einige Besonderheiten bei benutzerdefinierten Funktionen, die in Add-ons definiert sind:

• Versuchen Sie, einen eindeutigen Namen für Ihre Funktion zu erstellen, der möglicherweise mit dem Namen Ihres Add-ons zusammenhängt. 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. Geben Sie genaue JSDoc-Kommentare für Ihre benutzerdefinierten Funktionen an, 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 dem Fehler Internal error executing the custom function fehl. Sorgen Sie für eine gute Nutzererfahrung, indem Sie die Menge der Verarbeitung, die in einer benutzerdefinierten Funktion ausgeführt wird, 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. Wenn dies versucht wird, 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 einer Tabelle führt zu einem separaten Aufruf der Apps Script-Server. Wenn ein Nutzer versucht, benutzerdefinierte Funktionen in zu vielen Zellen zu verwenden, können die Funktionen langsam ausgeführt werden. 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 muss, 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 Sheets ausgeführt werden, und sie später mit einer Tastenkombination wiederholen. Wenn in einer Tabelle ein Makro erstellt wird, wird es als Makro funktion in einem Apps Script-Projekt hinzugefügt, das mit dieser Tabelle verknüpft 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 einfügen, ist sie für Nutzer dieses Add-ons nicht verfügbar.