Ein Google Sheets Script-Anfängerhandbuch

Wie man

DurchRyan Dube

Zuletzt aktualisiert am6. August 2020

Wenn Sie Google Sheets verwenden, könnte es Sie interessieren, dass Google Scripts Ihre Tabellenkalkulationen erheblich verbessern kann.

Denken Sie an Google Scripts wie VBA in Microsoft Excel. Sie können Ihrer Tabelle Code hinzufügen, um die Dateneingabe zu automatisieren. Sie können es auch verwenden, um externe Daten in Ihre Blätter zu bringen. Das Beste ist, dass Sie Berechnungen nach einem regelmäßigen Zeitplan ausführen können, auch wenn die Tabelle nicht geöffnet ist.

In diesem Artikel erfahren Sie, wie Sie Google Scripts aktivieren und ein einfaches Skript schreiben und ausführen.

So verwenden Sie Google Scripts

In Google Sheets müssen einige Dinge aktiviert sein, bevor Sie dort mit dem Schreiben von Google Scripts beginnen können.

Wählen Sie das Menü Extras und wählen Sie Script Editor aus dem Menü.

Dadurch wird der Google Scripts-Editor in einem Projektfenster ohne Titel geöffnet.

Dieses Skript ist tatsächlich in Ihrem Google-Konto im Google Scripts-Tool enthalten. Dieses spezielle Projekt ist mit der Tabelle verbunden, an der Sie gerade arbeiten.

Sie können ein Skript schreiben, es jedoch erst ausführen, wenn die Skripte tatsächlich im Blatt aktiviert sind. Sie müssen dies beim ersten Ausführen tun (wie Sie unten sehen werden).

Um dies in Aktion zu sehen, erstellen wir ein einfaches Skript.

Erstellen Sie Ihr erstes Google-Skript

In diesem Beispiel schreiben Sie ein Skript, das alle Quiz- und Abschlussprüfungsergebnisse für die B-Spalte (Chris 'Ergebnisse) addiert.

Dies ist die Beispieltabelle.

Fügen Sie im Google Scripts-Fenster den folgenden Code wie folgt in die geschweiften Klammern der Funktion myFunction () ein:


Funktion myFunction () {
var ss = SpreadsheetApp.getActiveSpreadsheet ();
var sheet = ss.getSheets () [0] var range = sheet.getRange (2,2,5);
var values ​​= range.getValues ​​();
var sum = 0
für (var Zeile in Werten) {
für (var col in values ​​[row]) {
sum = values ​​[row] [col] + sum;
}
}
sheet.getRange (7,2) .setValue (sum);
}


Dieser Code mag kompliziert aussehen, aber lassen Sie uns genau aufschlüsseln, was er tut. Es ist einfacher als es aussieht.

Lassen Sie uns diesen Code zeilenweise aufteilen.

Variablen definieren

1. var ss = SpreadsheetApp.getActiveSpreadsheet ();

Diese Zeile ruft die aktuelle Tabelle ab, die aktiv ist. Da Sie dieses Skript nur ausführen, wenn die Tabelle, für die Sie die Berechnung ausführen möchten, aktiv ist, wird immer die richtige Tabelle angezeigt. Das Blatt wird als "Objekt" -Variable mit dem Namen "ss" gespeichert.

2. var sheet = ss.getSheets () [0]

Dadurch wird das erste Blatt abgerufen und als Objektvariable mit dem Namen sheet gespeichert. Es gibt eine alternative Funktion, mit der Sie das Blatt anhand des Blattnamens ermitteln können.

Das wäre var sheet = ss.getSheetByName ("Sheet1");

Sie können jede der gewünschten Funktionen verwenden.

3. var range = sheet.getRange (2,2,5);

Diese Funktion erhält einen Wertebereich nach Zeile, Spalte und Anzahl der Zeilen. In diesem Fall werden alle Werte ab der zweiten Zeile, der zweiten Spalte und fünf Zeilen nach unten abgerufen.

Die Variable "Bereich" wird zu einem sogenannten "Array". Ein Array ist eine Variable, die mehrere Werte enthält. In Google Script verweisen Sie auf eine dieser Zahlen, indem Sie ein spezielles Elementadressierungsschema mit Klammern verwenden, wie Sie unten sehen werden.

4. var values ​​= range.getValues ​​();

Die Funktion getValues ​​() ruft die Werte tatsächlich aus dem oben definierten Bereichsobjekt ab.

5. var sum = 0

Dies ist nur eine einzelne Zahlenvariable, die wir mit der Zahl 0 initialisieren. Dies ist der Beginn der Zusammenfassung aller Zahlen in der Spalte.

Erstellen der For-Schleifen

6. für (var Zeile in Werten) {

Dies ist eine sogenannte "For" -Schleife. Diese Art von Schleife durchläuft eine bestimmte Anzahl von Elementen in einer Liste. In diesem Fall wird das oben beschriebene Array "values" durchlaufen. Diese erste Schleife durchläuft alle Zeilen im Array. In diesem Fall wird es nur einen geben.

Hinweis: Array-Zeilen sind nicht mit Tabellenzeilen identisch. Wenn das Array die Werte aus der Spalte in der Tabelle lud, fügte es sie in eine einzelne Zeile (oder Zeile) von Daten ein, wie folgt: „89, 92, 78, 98, 89“. In diesem Fall hat das Array also eine Zeile (Zeile) und fünf Zahlen (Spalten).

7. für (var col in values ​​[row]) {

Diese zweite for-Schleife durchläuft alle "Zeilen" im Array. In diesem Fall werden alle 5 Werte durchlaufen.

8. sum = values ​​[row] [col] + sum;

Jedes Mal, wenn die Schleife ausgeführt wird, addiert diese Anweisung die Summe des neuen Werts zu sich selbst. Bis alle 5 Schleifen auftreten, sollten alle 5 Zahlen in der Variablen "sum" summiert werden.

9 sheet.getRange (7,2) .setValue (sum);

Dies ist eine Anweisung mit zwei Funktionen. Die Funktion getRange zeigt auf die Zelle in der 7. Zeile und der 2. Spalte. Die Funktion setValue platziert dann den Wert der Variablen "sum" in dieser Zelle.

Nachdem Sie nun verstanden haben, wie jede Codezeile funktioniert, ist es an der Zeit, alles in Aktion zu sehen.

Speichern Ihres Google-Skripts

Sobald Sie Ihr Google-Skript eingegeben haben, können Sie es speichern und den Code durchgehen. Geben Sie zunächst "Projekt ohne Titel" ein, um Ihrem Projekt einen Namen zu geben. Wählen Sie dann das Diskettensymbol im Menü aus, um das Skript zu speichern.

Möglicherweise wird beim Speichern ein Fehler angezeigt. Keine Panik. Dies ist eigentlich ein Teil des Debugging-Prozesses. Achten Sie genau auf die Zeilennummer, in der steht, dass Sie einen Fehler haben. Sehen Sie sich Ihren Code genau an und beheben Sie eventuelle Tippfehler oder Syntaxfehler.

In diesem Beispiel fehlte in meiner "for" -Schleife in Zeile 8 das öffnende "(" - Symbol. Versuchen Sie nach dem Reparieren erneut, zu speichern. Sobald Sie Ihren Code speichern können, hält Google Ihre Codesyntax für in Ordnung.

Dies bedeutet nicht, dass Ihr Code wie beabsichtigt ausgeführt wird, sondern nur, dass er ohne Syntaxprobleme problemlos „kompiliert“ werden kann.

Ausführen Ihres Google-Skripts

Wählen Sie nun das Wiedergabesymbol oben, um Ihren Code zu durchlaufen. Da Sie Ihr neues Skript zum ersten Mal ausführen, müssen Sie der Google Script-App die Berechtigung zum Zugriff auf Ihre Tabelle (Daten) in Ihrem Google-Konto erteilen. Wählen Berechtigungen überprüfen im Popup-Fenster.

Sie müssen sich in Ihrem Google-Konto anmelden. Da es sich um eine benutzerdefinierte und keine bei Google registrierte App handelt, wird eine Warnung angezeigt, dass die App nicht überprüft wurde. Wähle aus Fortgeschrittene verknüpfen und dann auswählen Gehen Sie zu Beispiel für ein Google-Skript (unsicher). weitermachen.

Auf dem nächsten Bildschirm müssen Sie auswählen ermöglichen um Google Script Zugriff auf Ihr Google-Konto zu gewähren. Sobald Sie dies tun, wird das Skript ausgeführt.

Wenn Sie keine Fehler sehen, wechseln Sie zurück zur Tabelle. Die Ergebnisse Ihres Skripts sollten unten in der ersten Spalte angezeigt werden.

Schreiben erweiterter Google-Skripte

Dies war ein sehr einfaches Google-Skript, bei dem die Zellen einfach in einer einzigen Spalte zusammengefasst wurden. Wenn Sie den beiden For-Schleifen im Code Variablen hinzufügen möchten, können Sie auch alle Spalten durchlaufen und in Zeile 7 eine Zusammenfassung für alle Spalten bereitstellen.

Google Scripts bietet alle möglichen Möglichkeiten, wie z Senden von E-Mails aus einer Tabelle. Sie können sogar darauf tippen spezielle Google APIs Damit können Sie andere Google-Apps wie Google Mail, Kalender und sogar Google Analytics integrieren. Sobald Sie lernen, wie man Google-Skripte schreibt, sind die Möglichkeiten endlos.