Google Apps Script

Eigene Dialog-Box mit Google Apps Script erstellen

2011-01-11T10:09:00.001+01:00

Die Möglichkeiten bei der Interaktion mit dem Benutzer sind bei der Verwendung von Message- und Eingabe-Boxen für viele Fälle vollkommen ausreichend. Doch gibt es auch Anwendungsgebiete, in denen man zum Beispiel die Breite und Höhe der Box selber bestimmen möchte (damit der enthaltene Text nicht umbricht) oder man Buttons mit Texten versehen möchte, die standardmäßig nicht zur Verfügung stehen.

Um nun all das umzusetzen, bietet Google Apps Script die Ui Services an. Mit diesen lassen sich fast alle Elemente erstellen, die man in die Google Anwendungen sieht.

Das folgende Beispiel zeigt eine ganz einfache eigene Anwendung innerhalb eines Tabellen-Dokuments, welche nur eine Box erstellt und der Titel der Box definiert wird.

function myDialogBox() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var app = UiApp.createApplication();

  app.setTitle("Dialogbox");

  spreadsheet.show(app);
}

Führt man diese Funktion aus, erhält man eine solche Dialog-Box:

Einer solchen Box kann man nun verschiedene Elemente hinzufügen. Texte, Eingabefelder, Checkboxen, Buttons usw. Je nach Bedarf. Die Werte dieser Elemente kann man dann übrigens auch in die Tabelle übertragen oder anhand der Werte Aktionen mit der Tabelle durchführen. Aber das würde für den Anfang an dieser Stelle etwas zu weit führen. Um es gemütlich angehen zu lassen, zeigt das folgende Beispiel zunächst einmal nur, wie man die Höhe und Breite der Box festlegt sowie einen Text und einen Button zum Schließen der Box hinzufügt.

function myDialogBox() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var app = UiApp.createApplication();

  app.setHeight(100);
  app.setWidth(300);
  app.setTitle("Dialogbox");

  var text = app.createLabel("Hier steht der Text.");
  app.add(text);

  var closeButton = app.createButton("Schließen");
  app.add(closeButton);

  var handler = app.createServerClickHandler("closeDialogBox");
  closeButton.addClickHandler(handler);

  spreadsheet.show(app);
}

function closeDialogBox(e) {
  var app = UiApp.getActiveApplication();
  app.close();
  return app;
}

Führt man diese Funktion ("myDialogBox") aus, erhält man eine solche Dialog-Box:

Wie man dann Eingabeelemente in einer solchen Box erstellt und mit den Werten weiterarbeitet ... das gibt es in einem kommenden Artikel.

Automatischer Funktionsaufruf beim Bearbeiten einer Tabelle

2011-01-07T15:58:00.001+01:00

Möchte man automatisch eine Google Apps Script Funktion aufrufen, sobald eine Tabelle bearbeitet wurde, hat man dafür zwei Möglichkeiten:

Einfacher Event Handler sind bereits in Google Apps Script eingebaut. Um sie zu nutzen, muss man nur eine Funktion mit einem speziellen Namen (onOpen(), onEdit() oder onInstall()) erstellen. Der Inhalt der Funktion wird dann beim Eintreten des entsprechenden Events ausgeführt.

Um nun eine Funktion nach dem Bearbeiten einer Tabelle auszuführen, erstellt man eine Funktion mit dem Namen “onEdit”. Dieser wird ein Parameter "event" übergeben, der ein Objekt mit dem aktuellen Tabellen-Dokument enthält. Um das alles einmal auszuprobieren erstellt an ein neues Tabellen-Dokument, öffnet den Skripteditor (Tools -> Skripte -> Skripteditor) und erstellt folgende Funktion:

function onEdit(event) {
Browser.msgBox("Tabelle wurde bearbeitet.");
}

Nun noch die Funktion unter einem beliebigen Namen speichern und eine Änderung an der aktuellen Tabelle vornehmen. Voilà, eine Message-Box erscheint.

Doch warum die Übergabe des Parameters "event"? Was kann man damit machen? Ganz einfach. Der Inhalt dieses Parameters ist, wie bereits weiter oben geschrieben - aber hier sicherheitshalber ein zweites Mal, ein Objekt, welches das Tabellen-Dokument (Spreadsheet) enthält. Aus diesem Objekt kann man nun zum Beispiel die Information auslesen, welche Tabellenzelle gerade aktiv ist.

function onEdit(event) {
  var rowIndex = event.source.getActiveCell().getRowIndex();
  var columnIndex = event.source.getActiveCell().getColumnIndex();

  Browser.msgBox("Spalte: "+String(rowIndex));
  Browser.msgBox("Zeile: " + String(columnIndex));
}

Sind mehrere Tabellenzellen aktiv, wird übrigens immer die oberste linke zurückgegeben. Ach noch was: Führt man diese Funktion innerhalb des Skripteditors aus, erhält man eine Fehlermeldung wie diese hier: TypeError: Cannot read property "source" from undefined. (line 2). Keine Sorge. Es ist alles in Ordnung mit der Funktion. Funktion speichern, zur Tabelle wechseln und eine Änderung vornehmen. Geht!

So, nun zur zweiten Möglichkeit: Installierbare Event Handler. Komischer Name, aber etwas Besseres als Übersetzung für "Installable Event Handlers" wollte mir einfach nicht einfallen.

Hierbei ist der Name der Funktion nicht ausschlaggebend. Zum Ausprobieren erstellt man einfach eine Funktion mit dem Namen "myOnEdit":

function myOnEdit(event) {
Browser.msgBox("Tabelle wurde bearbeitet.");
}

Nun wählt man im Skripteditor den Menüpunkt Triggers -> All your Triggers aus und klickt in der angezeigten Dialogbox auf den Link "No triggers set up. Click here to add one now." (wenn man noch keinen Trigger angelegt hat) beziehungsweise "Add a new trigger" (wenn man bereits einen Trigger angelegt hat). In der Spalte "Run" wählt man aus der Select-Box die Option "myOnEdit" aus und in der Spalte "Events" wählt man bei der ersten Select-Box die Option "From spreadsheet" und bei der zweiten Select-Box die Option "On edit" aus. Speichern.

Zum Testen kann man nun Änderungen an der Tabelle durchführen und es erscheint nach jeder Änderung die Message-Box.

Fertig!

Debugging-Logs von Google Apps Script nutzen

2011-01-06T22:10:00.000+01:00

Beim Erstellen eines Scripts kann es mitunter nützlich sein, wenn man als Entwickler im Verlauf des Scripts einige Werte überprüft. Dazu könnte man zum Beispiel die Message-Box verwenden. Dies würde aber den Ablauf des Scripts etwas stören. Praktischer ist es, auf die zur Verfügung stehenden Debugging-Logs zurückzugreifen. In diese kann man im Verlauf eines Scripts beliebig Daten schreiben und sich dann am Ende alles in Ruhe ansehen.

In der folgenden einfachen Beispiel-Funktion wird eine for-Schleife durchlaufen. Bei jedem Schleifendurchlauf wird der Zählerwert mit der Methode log() der Klasse Logger ins Log geschrieben:

function myLogger() {
  for (var i = 0; i <= 10; i++) {
  Logger.log("i = " + String(i));
  }
}

Nach dem Ausführen der Funktion kann man sich das Debugging-Log über Ansicht -> Protokolle... ansehen.

Den Inhalt des Debugging-Logs kann man aber auch per Script abrufen, wenn man dies möchte. Google Apps Script stellt dafür die Methode getLog() der Klasse Logger zu Verfügung. Das folgende Beispiel zeigt, wie man den Inhalt des Debugging-Logs über eine Message-Box ausgibt:

function myLogger() {
  for (var i = 0; i <= 10; i++) {
  Logger.log("i = " + String(i));
  }

  Browser.msgBox(Logger.getLog());
}

Und so schaut es dann aus:

Eigene Menüs einem Tabellen-Dokument hinzufügen

2011-01-06T16:25:00.001+01:00

Vorhandene Google Apps Scripte eine Tabellen-Dokuments über das Menü Tools -> Skripte -> Verwalten von... zu starten ist zwar nicht allzu schwer, aber nicht sonderlich komfortabel. Um den Weg für den Aufruf eines Scripts zu verkürzen und auch den nicht so technisch versierten Nutzern etwas unter die Arme zu greifen, kann man mittels Google Apps Script über die Methode addMenu() eigene neue Menüeinträge erstellen und mit beliebigen Funktionen verknüpfen.

Damit die neuen Menüpunkte beim Öffnen des Tabellen-Dokuments automatisch hinzugefügt werden, erstellt man eine Funktion mit dem Namen onOpen() (siehe Events). Diese wird durch das System selbständig gestartet, sobald das Tabellen-Dokument geöffnet wird.

Das folgende Beispiel zeigt, wie man der Menüleiste einen neuen eigenen Hauptmenüpunkt "Mein Menü" mit drei Untermenüpunkten ("Eintrag 1", "Eintrag 2", "Eintrag 3") hinzufügt. Jeder Untermenüpunkt wird dabei mit einer eigenen Funktion verknüpft. Dies wird aufgerufen, sobald der Benutzer auf diesen klickt.

Führt man nun die Funktion onOpen() zum Test einmal aus, dann sieht man, wie nach dem letzten Standard-Menüpunkt "Hilfe" der neue Menüpunkt "Mein Menü" hinzugefügt wurde.

Möchte man die Untermenüpunkte etwas gruppieren, kann man zwischen diesen auch Trennlinien einfügen. Das folgende Beispiel zeigt, wie man eine solche Trennlinie zwischen dem zweiten und dritten Untermenüpunkt einfügt.

Im Tabellen-Dokument sieht dies nun so aus:

Inhaltsänderung einer Webseite automatisch überwachen

2011-01-05T12:44:00.005+01:00

Möchte man automatisch per E-Mail informiert werden, wenn sich der Inhalt einer bestimmten Webseite ändert, kann man dies mittels Google Apps Script realisieren. Dazu benötigt man zunächst eine beliebige App, die Google Apps Script unterstützt - zum Beispiel Text & Tabellen oder Sites. Hier erstellt man eine Funktion, die den Inhalt (also den HTML-Quelltext) einer Webseite abruft, mit dem bei einem vorherigen Funktionsaufruf gespeicherten Inhalt vergleicht und dann innerhalb des Dokuments speichert. Hat sich der Inhalt geändert, wird eine E-Mail verschickt. Diese Funktion lässt man nun über einen zeitbasierten Trigger automatisch in einem beliebigen Intervall aufrufen. Fertig.

Um es etwas anschaulicher zu gestalten habe ich mal eine solche Funktion erstellt, welche innerhalb einer Tabelle ausgeführt wird. Bitte zum Ausprobieren die eingetragene E-Mail-Adresse "max@mustermann.de" in die eigene ändern!

function checkWebContent() {
  var url = "http://www.apple.com/de/iphone/";

  var response = UrlFetchApp.fetch(url);
  var newContent = response.getContentText();

  var sheet = SpreadsheetApp.getActiveSheet();
  var cell = sheet.getRange("A1");
  var oldContent = cell.getValue();

  if (oldContent != newContent) {
  sheet.getRange("A1").setValue(newContent);
  MailApp.sendEmail(
  "max@mustermann.de",
  "Geänderter Inhalt",
  "Der Inhalt der Seite " + url + " hat sich geändert."
  );
  }
}

Funktion unter dem Namen "checkWebContent" speichern.

Für einen ersten Test, kann man diese Funktion mal im Skripteditor starten. Man sollte hierbei bereits eine E-Mail erhalten.

Nun geht es an den zeitbasierten Trigger zur automatischen Ausführung. Hierzu wählt man im Skripteditor den Menüpunkt Triggers -> All your Triggers aus und klickt in der angezeigten Dialogbox auf den Link "No triggers set up. Click here to add one now." (wenn man noch keinen Trigger angelegt hat) beziehungsweise "Add a new trigger" (wenn man bereits einen Trigger angelegt hat). In der Spalte "Run" wählt man den Namen der Funktion aus, in der Spalte "Events" wählt man "Time-driven" aus und definiert einen Intervall. Der folgende Screenshot zeigt einen zeitbasierten Trigger, welcher die Funktion checkWebContent jede Minute ausführt. Speichern.

Scripteditor schließen, Tabelle speichern, Tabelle schließen. Fertig. Nun kann man den Posteingang beobachten und geduldig auf die Benachrichtigungen warten. Die im oben genannten Beispielcode genannte Website wird sich sicher nicht so häufig ändern ... für mehr Benachrichtigungen einfach mal den URL "http://news.google.de/" einsetzen. Die E-Mails sollten dann im Minutentakt im Posteingang landen.

Interaktion Teil 2 - Eingabe-Box

2011-01-05T09:59:00.001+01:00

Nachdem es im ersten Teil zum Thema Interaktion mit dem Benutzer um die Message-Box ging, soll nun im zweiten Teil dieses Thema um die Eingabe-Box erweitert werden. Über die Message-Box kann man den Benutzer zwar eine einfache Frage stellen, auf die er allerdings nur sehr begrenzt (zum Beispiel mit "Ja" oder "Nein") antworten kann. Möchte man aber den Namen erfragen, muss man sich ein anderes Hilfsmittel suchen: Die Eingabe-Box. Diese hat zusätzlich zu den bekannten Elementen der Message-Box noch ein einzeiliges Eingabefeld. Eine solche Eingabe-Box wird in Google Apps Script mit der Methode inputBox() der Browser-Klasse erzeugt.

function myInputBox() {
  var name = Browser.inputBox(
  "Bitte geben Sie Ihren Namen ein:"
  );
}

Wird diese Funktion ausgeführt, dann sieht der Benutzer diese Eingabe-Box mit einem Titel, einem Schließen-Button in der rechten oberen Ecke, die Frage und einem OK-Button:

Über einen zweiten Parameter kann man zusätzlich noch definieren, welche Buttons in der Box angezeigt werden. Das folgende Beispiel zeigt, wie man einen OK- und einen Abbrechen-Button in die Box setzt:

function myInputBox() {
  var name = Browser.inputBox(
  "Bitte geben Sie Ihren Namen ein:",
  Browser.Buttons.OK_CANCEL
  );
}

Wird diese Funktion ausgeführt, dann sieht der Benutzer diese Eingabe-Box mit einem Titel, einem Schließen-Button in der rechten oberen Ecke, die Frage, einem OK- sowie einen Abbrechen-Button:

Alle möglichen Kombinationen der Buttons findet man übrigens hier.

Wie man in den bisherigen Beispielen gesehen hat, wird das Ergebnis (oder auch Rückgabewert) der Methode inputBox() in der Variable name gespeichert. Bei der Weiterverarbeitung dieses Wertes gilt es nun zu unterscheiden, ob der Benutzer wirklich einen Namen eingegeben hat, oder auf den Abbrechen-Button geklickt hat. Im folgenden Beispiel wird eine Message-Box angezeigt, wenn der Benutzer einen Namen eingegeben hat und auf den OK-Button geklickt hat. Andernfalls wird nichts gemacht.

function myInputBox() {
  var name = Browser.inputBox(
  "Bitte geben Sie Ihren Namen ein:",
  Browser.Buttons.OK_CANCEL
  );

  if (name != "cancel" && name != "") {
  Browser.msgBox("Hallo " + String(name) + ".");
  }
}

Die Eingabe-Box bietet, wie auch die Message-Box, die Möglichkeit, den Titel der Box selbst zu definieren. Dies geschieht über einen weiteren Parameter der Methode inputBox(). Hierbei ist unbedingt zu beachten, dass man beim Setzen des Titels alle drei Parameter (Titel, Text, Buttons) angeben muss.

function myInputBox() {
  var name = Browser.inputBox(
  "Frage",
  "Bitte geben Sie Ihren Namen ein:",
  Browser.Buttons.OK_CANCEL
  );

  if (name != "cancel" && name != "") {
  Browser.msgBox("Hallo " + String(name) + ".");
  }
}

Wird diese Funktion ausgeführt, dann sieht der Benutzer diese Eingabe-Box mit dem selbst definierten Titel, einem Schließen-Button in der rechten oberen Ecke, der Frage, einem OK- sowie einen Abbrechen-Button:

So, das zum Thema "Eingabe-Box". Demnächst mehr...

Interaktion Teil 1 - Message-Box

2011-01-04T14:00:00.001+01:00

Automation schön und gut, aber so richtig interessant wird es bei Google Apps Script erst durch die Interaktion mit dem Benutzer. Ich möchte aus diesem Grund an einigen Beispielen zeigen, wie ein Script mit dem Benutzer (oder der Benutzer mit dem Script ... ganz wie man will) interagieren kann.

Fangen wir mit einem ganz einfachen Beispiel an: Die Message-Box. Vielen Entwicklern, die bereits vor Google Apps Script mit JavaScript gearbeitet haben, wird die alert()-Funktion sehr geläufig sein. Das passende Entsprechung in Google Apps Script ist msgBox(). Dies ist eine Methode der Browser-Klasse. Das folgende Beispiel zeigt, wie man eine solche Message-Box aufruft:

function myMessageBox() {
Browser.msgBox("Das ist eine Message-Box.");
}

Wird diese Funktion ausgeführt, dann sieht der Benutzer diese Message-Box mit einem Titel, einem Schließen-Button in der rechten oberen Ecke, dem Text und einem OK-Button:

Einfach. Oder? Aber man möchte dem Benutzer nicht immer nur etwas mitteilen, sondern eventuell auch etwas fragen. Damit er dann auch entsprechend antworten kann, muss man ihm natürlich auch die passende Möglichkeit dazu bieten ... über die zur Verfügung gestellten Buttons. So kann man zum Beispiel fragen, ob der Benutzer heute Geburtstag hat und ihm für seine Antwort die Buttons "Ja" und "Nein" anbieten. Dies erreicht man über eine zusätzlichen Parameter der Methode.

function myMessageBox() {
  Browser.msgBox(
   "Haben Sie heute Geburtstag?",
  Browser.Buttons.YES_NO
  );
}

Wird diese Funktion ausgeführt, dann sieht der Benutzer diese Message-Box mit einem Titel, einem Schließen-Button in der rechten oberen Ecke, der Frage und den Buttons "Ja" und "Nein":

Alle möglichen Kombinationen der Buttons findet man übrigens hier.

Aber was bringt die Frage, wenn man nicht angemessen darauf reagieren kann? Nichts. So muss man nun noch die Antwort des Benutzers abfragen und weiter mit im interagieren. Wie wäre es mit einem "Herzlichen Glückwunsch!"?

function myMessageBox() {
  var answer = Browser.msgBox(
   "Haben Sie heute Geburtstag?",
  Browser.Buttons.YES_NO
  );

  switch (answer) {
  case "yes":
  Browser.msgBox("Herzlichen Glückwunsch!");
  break;
  case "no":
  Browser.msgBox("Schade.");
  break;
  }
}

Rein funktionell ist es das, was eine Message-Box kann. Allerdings ist der Standard-Titel "Google Apps Script" nicht so wirklich toll anzusehen. Diesen kann man ebenfalls über einen weiteren Parameter der Methode ändern. Hierbei ist allerdings zu beachten, dass man beim Setzen des Titels dann alle drei Parameter (Titel, Text, Buttons) angeben muss.

function myMessageBox() {
  var answer = Browser.msgBox(
   "Frage",
   "Haben Sie heute Geburtstag?",
  Browser.Buttons.YES_NO
  );

  switch (answer) {
  case "yes":
  Browser.msgBox("Herzlichen Glückwunsch!");
  break;
  case "no":
  Browser.msgBox("Schade.");
  break;
  }
}

Wird diese Funktion ausgeführt, dann sieht der Benutzer diese Message-Box mit dem selbst definierten Titel, einem Schließen-Button in der rechten oberen Ecke, der Frage und den Buttons "Ja" und "Nein":

So, das zum Thema "Message-Box". Demnächst mehr...

Funktion beim Öffnen einer Tabelle ausführen

2011-01-04T11:54:00.001+01:00

Eine ziemlich geniale Option bei Google Apps Script ist es, Funktionen beim Öffnen einer Tabelle automatisch ausführen zu lassen. Dazu muss man einfach eine Funktion mit dem Namen onOpen() erstellen. Sobald die Tabelle geöffnet wird, wird diese Funktion gestartet.

function onOpen() {
// beim Öffnen ausführen...
}

Als Beispiel will ich mal auf die bereits hier im Blog gezeigte Funktion zum Abrufen historischer Aktiendaten zurückgreifen. Es wäre doch prima, wenn automatisch die Daten der letzten 30 Tage geholt werden, sobald man die Tabelle öffnet. Dazu muss man nur die Datumsangaben für den Intervall (Start, Ende ... wobei Ende = heute und Start = heute - 30 Tage) dynamisch setzen und die Funktion durch die onOpen()-Funktion aufrufen. Wie das im Detail dann fertig aussieht, zeigt das folgende Beispiel:

Weitere Informationen zum automatischen und zeitgesteuerten Ausführen von Funktionen findet man in der Dokumentation zu Google Apps Script hier.

Namen aller Kalender mit Google Apps Script auslesen

2011-01-04T10:54:00.000+01:00

Das folgende Beispiel zeigt, wie man mit Google Apps Script die Namen aller Kalender im eigenen Account ausließt. Die Namen werden hierbei jeweils mit einer Message-Box ausgegeben.

function getMyCalendars() {
  var calendars = CalendarApp.getAllCalendars();

  for (var i = 0; i < calendars.length; i++) {
  Browser.msgBox(calendars[i].getName());
  }
}

Tabellenänderungen sofort sichtbar machen

2011-01-04T09:42:00.002+01:00

Schreibt man mittels Google Apps Script Daten in eine Tabelle, dann werden alle Änderungen normalerweise erst am Ende der Funktion auch sichtbar. Dies kann allerdings etwas verwirrend sein, wenn innerhalb der Funktion Daten anderer Dienste abgerufen werden und dies etwas länger dauert. Man hat dann das Gefühl, das nichts passiert und etwas schief gelaufen ist. Hier ein kleines Beispiel, um dieses Verhalten zu zeigen - erst nachdem die Schleife vollständig durchlaufen wurde, werden die Zahlen in die erste Spalte der Tabelle geschrieben.

function applyChanges() {
  var sheet = SpreadsheetApp.getActiveSheet();

  for (var i = 1; i < 10000; i++) {
  sheet.getRange("A"+String(i)).setValue(i);
  }
}

Google Apps Script bietet hier eine Methode an, um dieses Problem zu umgehen: flush(). Beim Aufruf dieser Methode werden alle ausstehenden Änderungen sofort umgesetzt. Das folgende Beispiel zeigt nun die um den Aufruf der flush()-Methode erweiterte Funktion - bereits während dem Durchlaufen der Schleife werden die Zahlen in die erste Spalte der Tabelle geschrieben.

function applyChanges() {
  var sheet = SpreadsheetApp.getActiveSheet();

  for (var i = 1; i < 10000; i++) {
  sheet.getRange("A"+String(i)).setValue(i);
  SpreadsheetApp.flush();
  }
}

Man sollte aber nicht zu exzessiv von der flush()-Methode Gebrauch machen. Denn es hat einen Grund, warum standardmäßig erst alle Daten gesammelt und erst am Ende in die Tabelle geschrieben werden: Performance. Jeder Aufruf von getRange(), getValue(), setValue() kostet Zeit. Werden die Aufrufe gesammelt, können sie optimiert und dann gebündelt ausgeführt werden.

Historische Aktiendaten mit Google Apps Script in Tabelle schreiben

2011-01-04T00:08:00.003+01:00

Wie ich bereits im vorherigen Artikel gezeigt habe, kann man mittels Google Apps Script aktuelle Daten zu Aktien abrufen. Aber auch Daten aus der Vergangenheit lassen sich sehr einfach abrufen.

Das folgende Beispiel zeigt, wie man den Schlusswert der Google-Aktie für alle Börsentage im Dezember 2010 abrufen und in eine Tabelle schreiben kann.

function getHistoricalStockData() {
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.clear();

  sheet.getRange("A1").setValue("Datum/Uhrzeit");
  sheet.getRange("B1").setValue("Wert");
  SpreadsheetApp.flush();

  var start = new Date("December 1, 2010");
  var end = new Date("December 31, 2010");
  var data = FinanceApp.getHistoricalStockInfo("GOOG", start, end, 1);

  for (var i = 0; i < data.stockInfo.length; i++) {
  var row = String(i+2)

  sheet.getRange("A"+row).setValue(data.stockInfo[i].time);
  sheet.getRange("B"+row).setValue(data.stockInfo[i].close);
  SpreadsheetApp.flush();
  }
}

Die Ausgabe dieses Scripts schaut so aus:

Aktiendaten mit Google Apps Script abrufen

2011-01-03T15:23:00.005+01:00

Mittels Google Apps Script kann man sehr einfach Informationen zu Aktien abrufen. Man benötigt dazu lediglich das Ticker-Symbol der gewünschten Aktie. Dieses ist zum Beispiel für Google "GOOG".

Das folgende Beispiel zeigt, wie man für die Google-Aktie den vollständigen Namen (name) der Firma und den aktuellen Preis (price) abruft:

function getStockData() {
  var stockData = FinanceApp.getStockInfo("GOOG");
  Browser.msgBox(stockData.name);
  Browser.msgBox(stockData.price);
}

Die Daten werden in diesem Beispiel jeweils durch eine Message-Box ausgegeben:

Natürlich kann man noch wesentlich mehr Informationen abrufen. Welche das sind, kann man im entsprechenden Teil der Dokumentation zu Google Apps Script nachschlagen.

E-Mails mit Google Apps Script versenden

2011-01-03T14:14:00.004+01:00

Das folgende einfache Beispiel zeigt, wie man mit Google Apps Script eine E-Mail versenden kann:

function emailExample() {
  MailApp.sendEmail(
  'max@mustermann.de',
  'Das ist der Betreff',
  'Das ist der Text.'
  );
}

Die Funktion sendEmail() erlaubt es zusätzlich, weitere Parameter anzugeben, um zum Beispiel den Namen des Absenders zu definieren (siehe nächstes Code-Beispiel). Standardmäßig wird hier nämlich nur die E-Mail-Adresse des Absenders eingesetzt.

function emailExample() {
  MailApp.sendEmail(
  'max@mustermann.de',
  'Das ist der Betreff',
  'Das ist der Text.',
  {'name':'Max Mustermann'}
  );
}

Response-Code für einen URL abfragen

2010-12-23T15:25:00.024+01:00

Wenn man mittels Google Apps Script den Response-Code für einen bestimmten URL abfragen möchte muss man beachten, dass dies nur für 2xx-Codes funktioniert. Das Problem ist nämlich, dass UrlFetchApp.fetch() nur für diesen Bereich richtig funktioniert. Ist der Server zum Beispiel nicht verfügbar oder der URL ist mit einer Zugriffssperre geschützt, verursacht UrlFetchApp.fetch() eine JavaException.

Evin Levey, ein Google-Angestellter meint dazu: "This is actually 'by design', and it's a bit of an ugly design." Ich würde das allerdings als ernsthaften Bug bezeichnen.

Um es selbst auszuprobieren, kann man folgende Funktion nutzen:

Um das Problem zu umgehen, nutzt man am besten die aus JavaScript bekannte try/catch Syntax. Innerhalb des catch-Teils kann man dann mit einem kleinen regulären Ausdruck den Response-Code aus der JavaException extrahieren.

Kontakt-Gruppen in eine Tabelle schreiben

2010-12-23T12:07:00.008+01:00

Das folgende Beispiel zeigt, wie man mit Google Apps Script Kontakt-Gruppen in eine Tabelle schreibt.

function writeContactGroupNamesToSpreadsheet() {

  // alle Gruppen abrufen
  var groups = ContactsApp.getContactGroups();

  // aktuelle Tabelle ermitteln
  var sheet = SpreadsheetApp.getActiveSheet();

  // Zelle in der aktuelle Tabelle definieren
  var range = sheet.getRange("A1");

  // Spaltentitel schreiben
  range.setValue('Group names');

  // Gruppennamen in die Tabelle schreiben
  for ( var i = 0; i < groups.length; i++ ) {
  // Name der aktuellen Gruppe ermitteln
  name = groups[i].getName();

  // Zelle in der Tabelle definieren
  var range = sheet.getRange("A"+String(i+2));

  // Gruppenname in die definierte Zelle der Tabelle schreiben
  range.setValue(name);
  }

}

Namen der Kontakt-Gruppen auslesen

2010-12-23T10:16:00.012+01:00

Das folgende Beispiel zeigt, wie man mit Google Apps Script die Namen der Kontakt-Gruppen ausließt.

function myContactGroups() {
  var groups = ContactsApp.getContactGroups();

  for ( i in groups ) {
  var group = groups[i];
  var name = group.getName();
  Browser.msgBox(name);
  }
}

Es existieren einige Standard-Gruppen: "My Contacts", "Friends", "Family" und "Coworkers"), die alle den Präfix "System Group: " im Namen tragen. Um diesen Präfix zu entfernen kann man einen regulären Ausdruck verwenden, wie es die folgende etwas erweiterte Funktion zeigt.

function myContactGroups() {
  var groups = ContactsApp.getContactGroups();

  for ( i in groups ) {
  var group = groups[i];
  var name = group.getName();
  name = name.replace('System Group: ', '');
  Browser.msgBox(name);
  }
}