Praktische Übung mit Google Apps Script: Mit nur vier Codezeilen können Sie auf Google Tabellen, Google Maps und Gmail zugreifen.

1. Einführung in Google Apps Script

In diesem Codelab lernen Sie, wie Sie mit JavaScript, einer der gängigsten Programmiersprachen, ganz einfach Code schreiben können, mit dem Sie auf die Google-Entwicklertools zugreifen können. Dazu wird JavaScript verwendet, eine gängige Programmiersprache für die Webentwicklung. Mithilfe von Google Apps Script-Code haben Sie beispielsweise die Möglichkeit, eine Adresse aus einer Zelle in einer Tabelle in Google Sheets zu extrahieren, anhand dieser Adresse in Google Maps eine Karte zu erstellen und dann die Karte als Anhang über Gmail zu versenden. Und das Beste ist: Es sind nur vier Zeilen Code.

Lerninhalte

  • Google Apps Script mit verschiedenen Google-Diensten wie Google Sheets, Google Maps und Gmail verwenden
  • Code mit dem In-Browser-Editor für Apps Script entwickeln

Voraussetzungen

  • Einen Webbrowser mit Internetzugriff
  • Ein Google-Konto (für Google Workspace-Konten ist möglicherweise die Genehmigung durch den Administrator erforderlich)
  • Grundlegende Kenntnisse von Google Sheets
  • Kann die A1-Notation von Google Sheets lesen

2. Umfrage

Wie werden Sie dieses Codelab/diese Anleitung verwenden?

Nur lesen Lesen und Übungen durchführen

Wie würden Sie Ihre Erfahrungen mit den Google Workspace-Entwicklertools und ‑APIs bewerten?

Anfänger Mittelstufe Fortgeschritten

3. Übersicht

Jetzt wissen Sie, worum es in diesem Codelab geht. Was genau werden Sie tun?

  1. Apps Script basiert auf JavaScript.
  2. Erstellen Sie eine Google Sheets-Tabelle.
  3. Geben Sie in die Zelle oben links (A1) des Tabellenblatts eine Adresse ein.
  4. Informationen zum Öffnen des Apps Script-Editors für ein beliebiges Dokument
  5. Apps Script-Code bearbeiten, speichern und ausführen
  6. Verwenden Sie Gmail, um das Ergebnis anzusehen.

Legen wir los!

Was ist Google Apps Script?

Google Apps Script ist eine Entwicklungsplattform, mit der Sie schnell und einfach Skripts und kleine Anwendungen erstellen können, die sich in Google Workspace einbinden lassen. Apps Script bietet folgende Vorteile:

  • Code in JavaScript schreiben und auf integrierte Bibliotheken für Google Workspace-Anwendungen wie Gmail, Google Kalender und Google Drive zugreifen
  • Sie müssen nichts installieren – wir stellen Ihnen einen Code-Editor direkt in Ihrem Browser zur Verfügung und Ihre Skripts werden auf den Servern von Google ausgeführt.
  • Sie müssen sich nicht um komplexe Themen wie Sicherheit und Berechtigungen für den Datenzugriff kümmern, da die Plattform dies für Sie übernimmt.

Mit Apps Script lassen sich verschiedene Anwendungen erstellen, von Chatbots bis hin zu Web-Apps. Eine der beliebtesten Anwendungen ist die Erweiterung der Funktionalität einer Google-Tabelle. Im weiteren Verlauf dieses Codelabs erfahren Sie, wie Sie mit Apps Script Daten aus einer Tabelle abrufen und mit anderen Google-Diensten verbinden.

4. Google-Tabelle erstellen und eine Adresse eingeben

Geben Sie anhand der folgenden Schritte eine gültige Adresse in eine neue Tabelle in Google Sheets ein:

  1. Erstellen Sie eine Google-Tabelle über diesen Link: sheets.google.com/create. Alternativ können Sie auch drive.google.com aufrufen und auf Neu > Google Sheets > Leere Tabelle klicken.

413a93e5b2f6b3d4.png

  1. Klicken Sie im leeren Tabellenblatt links oben auf die erste Zelle (A1). Die Zelle ist in Spalte A und Zeile 1. Wenn Sie sich noch einmal damit vertraut machen möchten, finden Sie hier eine Beschreibung der A1-Notation.
  2. Geben Sie eine gültige Adresse in die Zelle ein. Wählen Sie eine Adresse mit einem genauen Standort aus, indem Sie eine Adresse, eine Postleitzahl oder eine Kombination aus Stadt und Bundesland angeben. Hier ist ein Beispiel für eine Adresse in New York City:

7077e446455639df.png

Mehr ist in der Tabelle nicht zu tun. Öffnen wir den Editor und schreiben wir etwas Code.

5. Apps Script-Code bearbeiten

Sie haben eine neue Tabelle in Google Sheets erstellt und können jetzt deren gebundenes Skript bearbeiten. Folge dazu einfach diesen Schritten:

Script-Editor öffnen

Wählen Sie in der Menüleiste Erweiterungen > Apps Script aus, um den Browser-Code-Editor für Apps Script zu öffnen.

In einem neuen Browsertab wird im Codeeditor das standardmäßige containergebundene Skript für das Tabellenblatt angezeigt. Eine Standardfunktion mit dem Namen myFunction() wird automatisch erstellt und der Cursor wird in die Funktion gesetzt, damit Sie direkt loslegen können.

Google Maps-Karte der Adresse per E-Mail senden

Die Vorlage für den Code ist leer. Setzen Sie stattdessen unsere Anwendung ein.

  1. Ersetzen Sie im Skript-Editor den Standardcodeblock myFunction() durch den folgenden Code:
/** @OnlyCurrentDoc */
function sendMap() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var address = sheet.getRange('A1').getValue();
  var map = Maps.newStaticMap().addMarker(address);
  GmailApp.sendEmail('YOUR_EMAIL_ADDR', 'Map', 'See below.', {attachments:[map]});
}
  1. Ersetzen Sie die Platzhalter-E-Mail-Adresse ('YOUR_EMAIL_ADDR') durch eine gültige. Beispiel: friend@example.com.
  2. Klicken Sie auf „Speichern“ Speichern, um das Script zu speichern.
  3. Wenn Sie Ihr Apps Script-Projekt umbenennen möchten, klicken Sie auf Unbenanntes Projekt, geben Sie einen Titel für Ihr Projekt ein und klicken Sie auf Umbenennen.

Code Review

Sehen wir uns die vier Zeilen der sendMap()-Funktion an, aus denen die gesamte Anwendung besteht. Interessanterweise verweist der Code auf drei verschiedene Google-Produkte.

Die erste Zeile ist ein Anmerkungskommentar, der sich auf die Autorisierung auswirkt:

/** @OnlyCurrentDoc */

Die meisten Skripts fragen den Nutzer vor der Ausführung nach einigen Berechtigungen. Mit diesen Berechtigungen wird festgelegt, was das Skript tun darf. Die erste Zeile ist ein Kommentar mit einer optionalen Annotation, die Apps Script anweist, den Zugriff auf die aktuelle Tabelle zu beschränken (im Gegensatz zu allen Tabellen des Nutzers). Es empfiehlt sich immer, diese Annotation einzufügen, wenn Sie nur mit einer einzelnen Datei arbeiten.

Im Code wird eine normale JavaScript-Funktionsdeklaration für sendMap() verwendet:

function sendMap() {

In der nächsten Zeile wird der Spreadsheet Service aufgerufen, auf den von Apps Script über das Objekt SpreadsheetApp zugegriffen werden kann. Die zurückgegebene Tabelle wird einer Variablen mit demselben Namen zugewiesen. Die Methode getActiveSheet() ruft einen Verweis auf das aktuelle Tabellenblattobjekt ab und speichert ihn in der Variablen sheet.

  var sheet = SpreadsheetApp.getActiveSheet();

Mit dem Objekt sheet wird auf den Zellenbereich (einer einzelnen Zelle) in A1-Schreibweise mit getRange() verwiesen. Ein „Bereich“ ist eine Gruppe von Zellen oder auch nur eine Zelle, in unserem Fall die Zelle A1, in die Sie die Adresse eingegeben haben. Um abzurufen, was innerhalb des Bereichs liegt, gibt die Methode getValue() den Wert der Zelle oben links im Bereich zurück und weist ihn der Variablen address zu. Sie können auch versuchen, weitere Adressen hinzuzufügen und aus anderen Zellen auszulesen.

  var address = sheet.getRange('A1').getValue();

Die dritte Codezeile stellt über das Objekt Maps eine Verbindung zu Google Maps her. Mit newStaticMap() wird ein statisches Kartenobjekt erstellt und mit der Methode addMarker() wird der Karte anhand der Adresse in der Tabelle eine Stecknadel hinzugefügt.

  var map = Maps.newStaticMap().addMarker(address);

Schließlich wird mit dem Gmail-Dienst über das MailApp-Objekt die Methode sendEmail() aufgerufen, um die E‑Mail zu senden, die den Text „See below.“ und das Bild der Karte als Anhang enthält.

  GmailApp.sendEmail('friend@example.com', 'Map', 'See below.', {attachments:[map]});
}

6. Google Sheets, Google Maps und Gmail ausführen

Nachdem Sie die Funktion benannt und gespeichert haben, können Sie sie ausführen. Achten Sie darauf, dass oben im Editor sendMap() in der Funktionsliste ausgewählt ist, und klicken Sie auf Ausführen.

Ein Feature, das Entwickler an Apps Script besonders schätzen, ist, dass man keinen Autorisierungscode schreiben muss, der dem Programm Zugriff auf die Daten des Nutzers gewährt. Obwohl Apps Script die Autorisierung verwaltet, müssen die Nutzer Ihrer Anwendung dem Skript trotzdem die Berechtigung erteilen, auf ihre Tabellen zuzugreifen und in ihrem Auftrag über Gmail E-Mails zu senden. Das erste Autorisierungsdialogfeld sieht so aus:

ba6e1a798e404e0d.png

Klicken Sie auf Berechtigungen ansehen, um fortzufahren.

Als Nächstes sehen Sie das OAuth2-Dialogfeld, in dem Sie gefragt werden, ob das Skript auf Ihre Tabelle zugreifen und in Ihrem Auftrag E-Mails senden darf:

9bed7ef1ccbd7569.png

Sobald Sie die Berechtigung erteilen, wird die Ausführung des Skripts abgeschlossen.

Sehen Sie jetzt in Ihrem E‑Mail-Konto nach, an das Sie die Nachricht gesendet haben. Sie sollten eine E‑Mail mit dem Betreff „Map“ sehen, deren Nachrichtentext so aussieht:

51f61fc51a13d28f.png

Wenn Sie den Anhang in der E‑Mail öffnen, sollte eine Google-Karte mit einer Markierung für die Adresse angezeigt werden, die Sie in die Tabelle eingegeben haben:

739bb45b75e3f7c7.png

Mit nur vier Zeilen Code haben Sie auf drei verschiedene Google-Produkte zugegriffen.

7. Zusätzliche Ressourcen

Den Code aus diesem Codelab finden Sie auch im GitHub-Repository unter github.com/googleworkspace/apps-script-intro-codelab. Unten finden Sie weitere Ressourcen, die detaillierte Informationen zu den Inhalten in diesem Codelab sowie zu Möglichkeiten für einen programmatischen Zugriff auf die Google-Entwicklertools enthalten.

Dokumentation

Videos

Neuigkeiten & Updates

Weitere Codelabs

Einführung

Fortgeschritten

Referenzanwendungen