Erweitern von Google-Tabellen

Mit Google Apps Script können Sie mit Google Tabellen neue und coole Dinge tun. Mit Apps Script können Sie Google Tabellen benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzufügen. Außerdem können Sie benutzerdefinierte Funktionen für Google Tabellen schreiben und Google Tabellen in andere Google-Dienste wie Kalender, Drive und Gmail einbinden.

Die meisten Skripts, die für Google Tabellen entwickelt wurden, ändern Arrays so, dass sie mit den Zellen, Zeilen und Spalten in einer Tabelle interagieren. Wenn du mit Arrays in JavaScript nicht vertraut bist, bietet Codecademy ein großartiges Trainingsmodul für Arrays. Hinweis: Dieser Kurs wurde nicht von Google entwickelt und steht nicht in Verbindung mit Google.

Eine kurze Einführung in die Verwendung von Apps Script mit Google Tabellen finden Sie in der 5-minütigen Kurzanleitung für Makros, Menüs und benutzerdefinierte Funktionen.

Erste Schritte

Apps Script enthält spezielle APIs, mit denen Sie Google Tabellen programmatisch erstellen, lesen und bearbeiten können. Apps Script kann auf zwei Arten mit Google Tabellen interagieren: Jedes Skript kann eine Tabelle erstellen oder ändern, wenn der Nutzer des Skripts die entsprechenden Berechtigungen für die Tabelle hat. Ein Skript kann auch an eine Tabelle gebunden werden. Dadurch hat das Skript besondere Möglichkeiten, die Benutzeroberfläche zu ändern oder zu reagieren, wenn die Tabelle geöffnet wird. Wählen Sie in Google Tabellen Erweiterungen > Apps Script aus, um ein gebundenes Skript zu erstellen.

Der Tabellendienst behandelt Google Tabellen wie ein Raster, das zweidimensionale Arrays umfasst. Um die Daten aus der Tabelle abzurufen, müssen Sie Zugriff auf die Tabelle erhalten, in der die Daten gespeichert sind, den Bereich in der Tabelle abrufen, die die Daten enthält, und dann die Werte der Zellen abrufen. Apps Script erleichtert den Zugriff auf die Daten, indem es strukturierte Daten aus der Tabelle ausliest und JavaScript-Objekte für sie erstellt.

Daten lesen

Angenommen, Sie haben eine Liste mit Produktnamen und Produktnummern, die Sie in einer Tabelle speichern, wie in der folgenden Abbildung dargestellt.

Das folgende Beispiel zeigt, wie die Produktnamen und Produktnummern abgerufen und protokolliert werden.

function logProductInfo() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  for (var i = 0; i < data.length; i++) {
    Logger.log('Product name: ' + data[i][0]);
    Logger.log('Product number: ' + data[i][1]);
  }
}

Logs ansehen

Wenn Sie sich die protokollierten Daten ansehen möchten, klicken Sie oben im Skripteditor auf Ausführungsprotokoll.

Daten schreiben

Wenn Sie Daten wie einen neuen Produktnamen und eine neue Produktnummer in der Tabelle speichern möchten, fügen Sie den folgenden Code am Ende des Skripts ein.

function addProduct() {
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.appendRow(['Cotton Sweatshirt XL', 'css004']);
}

Mit dem obigen Code wird am Ende der Tabelle eine neue Zeile mit den angegebenen Werten angehängt. Wenn Sie diese Funktion ausführen, wird der Tabelle eine neue Zeile hinzugefügt.

Benutzerdefinierte Menüs und Benutzeroberflächen

Sie können Google Tabellen anpassen, indem Sie benutzerdefinierte Menüs, Dialogfelder und Seitenleisten hinzufügen. Grundlegende Informationen zum Erstellen von Menüs finden Sie im Leitfaden zu Menüs. Weitere Informationen zum Anpassen des Inhalts eines Dialogfelds finden Sie im Leitfaden zum HTML-Dienst.

Sie können eine Skriptfunktion auch an ein Bild oder eine Zeichnung in einer Tabelle anhängen. Die Funktion wird ausgeführt, wenn ein Nutzer auf das Bild oder die Zeichnung klickt. Weitere Informationen finden Sie unter Bilder und Zeichnungen in Google Tabellen.

Wenn Sie die benutzerdefinierte Oberfläche als Teil eines Add-ons veröffentlichen möchten, folgen Sie der Styleanleitung, um sie an den Stil und das Layout des Google Tabellen-Editors anzupassen.

Mit Google Formulare verbinden

Mit Apps Script können Sie Google Formulare über Formulare und Tabellendienste mit Google Tabellen verbinden. Mit dieser Funktion kann anhand von Daten in einer Tabelle automatisch ein Google-Formular erstellt werden. Mit Apps Script können Sie auch Trigger wie onFormSubmit verwenden, um eine bestimmte Aktion auszuführen, nachdem ein Nutzer auf das Formular geantwortet hat. Weitere Informationen zum Verbinden von Google Tabellen mit Google Formulare finden Sie in der 5-minütigen Kurzanleitung Antworten für Google Formulare verwalten.

Formatierung

Die Klasse Range bietet Methoden wie setBackground(color), um auf das Format einer Zelle oder eines Zellenbereichs zuzugreifen und diese zu ändern. Das folgende Beispiel zeigt, wie Sie den Schriftstil eines Bereichs festlegen können:

function formatMySpreadsheet() {
  // Set the font style of the cells in the range of B2:C2 to be italic.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var cell = sheet.getRange('B2:C2');
  cell.setFontStyle('italic');
}

Datenvalidierung

Mit Apps Script können Sie auf vorhandene Datenvalidierungsregeln in Google Tabellen zugreifen oder neue Regeln erstellen. Im folgenden Beispiel wird gezeigt, wie eine Datenvalidierungsregel festgelegt wird, die in einer Zelle nur Zahlen zwischen 1 und 100 zulässt.

function validateMySpreadsheet() {
  // Set a rule for the cell B4 to be a number between 1 and 100.
  var cell = SpreadsheetApp.getActive().getRange('B4');
  var rule = SpreadsheetApp.newDataValidation()
     .requireNumberBetween(1, 100)
     .setAllowInvalid(false)
     .setHelpText('Number must be between 1 and 100.')
     .build();
  cell.setDataValidation(rule);
}

Weitere Informationen zum Verwenden von Datenvalidierungsregeln finden Sie unter SpreadsheetApp.newDataValidation(), DataValidationBuilder und Range.setDataValidation(rule)

Charts

Mit Apps Script können Sie Diagramme in einer Tabellenkalkulation einbetten, die die Daten in einem bestimmten Bereich darstellen. Im folgenden Beispiel wird ein eingebettetes Balkendiagramm generiert, wobei davon ausgegangen wird, dass diagrammfähige Daten in den Zellen A1:B15 vorhanden sind:

function newChart() {
  // Generate a chart representing the data in the range of A1:B15.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
     .setChartType(Charts.ChartType.BAR)
     .addRange(sheet.getRange('A1:B15'))
     .setPosition(5, 5, 0, 0)
     .build();

  sheet.insertChart(chart);
}

Weitere Informationen zum Einbetten eines Diagramms in Ihre Tabelle finden Sie unter EmbeddedChart und in bestimmten Diagrammgeneratoren wie EmbeddedPieChartBuilder.

Benutzerdefinierte Funktionen in Google Tabellen

Eine benutzerdefinierte Funktion ähnelt einer integrierten Tabellenkalkulationsfunktion wie =SUM(A1:A5), mit der Ausnahme, dass Sie das Verhalten der Funktionen mit Apps Script definieren. Sie können beispielsweise die benutzerdefinierte Funktion in2mm() erstellen, die einen Wert von Zoll in Millimeter umwandelt. Dann können Sie die Formel in Ihrer Tabelle verwenden, indem Sie =in2mm(A1) oder =in2mm(10) in eine Zelle eingeben.

Weitere Informationen zu benutzerdefinierten Funktionen finden Sie in der fünfminütigen Kurzanleitung Menüs und benutzerdefinierte Funktionen oder im ausführlichen Leitfaden zu benutzerdefinierten Funktionen.

Makros

Makros sind eine weitere Möglichkeit, Apps Script-Code über die Benutzeroberfläche von Google Tabellen auszuführen. Im Gegensatz zu benutzerdefinierten Funktionen können Sie sie mit einer Tastenkombination oder über das Google Tabellen-Menü aktivieren. Weitere Informationen finden Sie unter Google Tabellen-Makros.

Add-ons für Google Tabellen

Add-ons sind speziell gepackte Apps Script-Projekte, die in Google Tabellen ausgeführt und über den Google Tabellen-Add-on-Store installiert werden können. Wenn Sie ein Skript für Google Tabellen entwickelt haben und es mit der ganzen Welt teilen möchten, können Sie es mit Apps Script als Add-on publish. So können andere Nutzer es aus dem Add-on-Store installieren.

Trigger

Für Skripts, die an eine Google Tabellen-Datei gebunden sind, können einfache Trigger wie die Funktionen onOpen() und onEdit() verwendet werden, um automatisch zu reagieren, wenn ein Nutzer, der Bearbeitungszugriff auf die Tabelle hat, die Tabelle öffnet oder bearbeitet.

Wie einfache Trigger ermöglichen installierbare Trigger, dass Google Tabellen eine Funktion automatisch ausführt, wenn ein bestimmtes Ereignis eintritt. Installierbare Trigger bieten jedoch mehr Flexibilität als einfache Trigger und unterstützen die folgenden Ereignisse: „open“, „edit“, „change“, „das Senden von Formularen“ und „zeitgesteuert“ (Uhr).