AppSheet mit Apps Script verbinden

1. Einführung

In diesem Codelab erstellen Sie ein Apps Script-Projekt namens „Hello World“ und fügen dann eine einfache Funktion, logThis, hinzu, die eine an sie übergebene Nachricht protokolliert. Anschließend erstellen Sie eine AppSheet-Automatisierung, die das Skript aufruft. Nachdem das Script aufgerufen wurde, kehren Sie zum Apps Script-Editor zurück und bestätigen die Ausführung.

Lerninhalte

Apps Script-Projekt mit einer einfachen Funktion erstellen
So erstellen Sie eine einfache AppSheet-App auf Grundlage einer vorhandenen Google-Tabelle.
So erstellen Sie eine AppSheet-Automatisierung, die die Script-Funktion aufruft.
So prüfen Sie, ob das Skript in AppSheet erfolgreich ausgeführt wurde.

Voraussetzungen

Zugriff auf die AppSheet-Entwicklungsumgebung (appsheet.com).
Zugriff auf die Apps Script-Entwicklungsumgebung (script.google.com).

2. Apps Script-Projekt erstellen

Erstellen Sie zuerst ein Apps Script-Projekt mit dem Namen „Hello World“ und fügen Sie dann eine einfache Funktion, logThis, hinzu, die eine an sie übergebene Nachricht protokolliert.

Rufen Sie die Apps Script-Startseite auf und klicken Sie auf + Neues Projekt.
Ändere den Titel des Projekts in Hello World. .
Aktualisieren Sie das Skript im Editor so:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

Klicken Sie auf Projekt speichern.

Weitere Informationen finden Sie unter Projekte erstellen und löschen.

3. AppSheet-App erstellen

Als Nächstes erstellen Sie schnell eine neue AppSheet-App auf Grundlage einer kopierten Beispiel-Google-Tabelle und aktualisieren sie dann, um das zuvor erstellte Apps Script-Projekt aufzurufen.

Öffnen Sie die Tabelle Shirt Orders Example (Beispiel für T-Shirt-Bestellungen) und klicken Sie dann auf Kopie erstellen, um eine Kopie herunterzuladen und in Google Sheets zu öffnen. Sie können die Tabelle bei Bedarf umbenennen, z.B. in „T-Shirt-Bestellungen“.
Melden Sie sich in AppSheet an.
Klicken Sie auf der Seite „Meine Apps“ auf + Neue App erstellen. Das Dialogfeld Neue App erstellen wird angezeigt.
Klicken Sie auf Mit eigenen Daten beginnen.
Bearbeiten Sie optional den App-Namen und wählen Sie eine Kategorie aus.
Klicken Sie auf Daten auswählen.

Wenn Sie im Dialogfeld zum Erstellen einer neuen App „Daten auswählen“ auswählen.

Klicken Sie auf google, um auf Google Drive zuzugreifen.
Rufen Sie die Tabelle Shirt Orders auf, die Sie zuvor kopiert haben, und wählen Sie sie aus.

AppSheet richtet Ihre App ein. Erstes Vorschaufenster für die generierte App.

Klicken Sie auf App anpassen, um die App im AppSheet-Editor zu öffnen.

4. Automatisierung erstellen

Als Nächstes erstellen Sie eine AppSheet-Automatisierung, mit der das Script aufgerufen wird.

Wählen Sie Automatisierung > Bots aus.
Klicken Sie auf + Neuer Bot.
Wählen Sie den ersten Vorschlag in der Liste aus: When a Shirt Orders record is created or updated, send a notification. (Wenn ein Datensatz für Shirt-Bestellungen erstellt oder aktualisiert wird, sende eine Benachrichtigung.)

Klicken Sie auf den Schritt Benachrichtigung senden, um ihn zu bearbeiten.
Ändern Sie den Namen in Call a script.

Automatisierungsschritte zum Aufrufen eines Skripts.

Ändern Sie unter Einstellungen den Aufgabentyp in Skript aufrufen.

Sie wählen in den Automatisierungseinstellungen den Aufgabentyp „Script aufrufen“ aus.

Klicken Sie im Feld Apps Script-Projekt auf Durchsuchen (Dateisymbol).
Rufen Sie das Hello World Apps Script-Projekt in Google Drive auf und wählen Sie es aus.
Klicken Sie auf Auswählen und dann auf Autorisieren, wenn Sie dazu aufgefordert werden. Folgen Sie der Anleitung.

Das Apps Script-Projekt wird hinzugefügt und das Feld Funktionsname wird mit einer Liste der verfügbaren Funktionen gefüllt.

Wählen Sie logThis(msg) aus der Liste Funktionsname aus.

Das Feld Funktionsargumente wird angezeigt.

Geben Sie für das Argument msg den folgenden Ausdruck mit dem Ausdrucksassistenten ein: ‘Hello from AppSheet'

Argumente zum Apps Script-Funktionsaufruf hinzufügen

Klicken Sie auf Speichern, um die App zu speichern.
Klicken Sie im Vorschaufenster auf das Smartphone- oder Tablet-Symbol, um den App-Emulator aufzurufen.

Füge eine neue T-Shirt-Bestellung hinzu und klicke auf Speichern.
Klicken Sie auf Synchronisieren, um die Änderungen zu synchronisieren.

Klicken Sie rechts oben im Vorschaufenster auf das Synchronisierungssymbol, um die Synchronisierung mit der Datenquelle zu starten.

5. Ausführung von Apps Script bestätigen

Kehren Sie nach dem Aufrufen des Skripts zum Apps Script-Editor zurück und bestätigen Sie die Ausführung.

Kehren Sie zur Apps Script-Startseite zurück und rufen Sie das Projekt Hello World auf.
Klicken Sie in der Navigationsleiste auf Ausführungen, um zu bestätigen, dass die Funktion logThis erfolgreich abgeschlossen wurde. Klicken Sie auf Aktualisieren, wenn das Log nicht angezeigt wird.

Ausführungslogs in der Apps Script-Editorumgebung ansehen, um zu prüfen, ob die Funktion über den AppSheet-Aufruf ausgeführt wurde.

6. Optionale zusätzliche Schritte

Als zusätzlichen Schritt in diesem Workshop können Sie das Projekt „Apps Script Examples“ (Apps Script-Beispiele) aufrufen und einige der Beispiele in AppSheet ausführen.

Erste Schritte mit den Apps Script-Beispielen

Erstellen Sie zuerst eine Kopie des Apps Script-Beispielprojekts.
Klicken Sie auf das Kopiersymbol.
Speichern Sie das neue Projekt und klicken Sie auf Ausführen, um die Apps im Projekt zu autorisieren.

Mit mehreren Beispielen experimentieren

createCalendarEvent() – Erstellen Sie einen neuen Kalendertermin.
createDoc(): Erstellt automatisch ein neues Dokument.
createSheet(): Erstellt ein neues Tabellenblatt.
createSlideDeck(): Erstellen Sie eine neue Präsentation mit einem Bild und Text.

Weitere Informationen zu dieser wichtigen Funktion finden Sie unter Apps Script über eine Automatisierung aufrufen. Dort finden Sie eine detaillierte Übersicht, ein Funktionsvideo, Anleitungen und ein kopierbares Apps Script-Projekt mit vielen AppSheet-Apps Script-Beispielen.