Apps Script-Beispiel-Web-App

Auf dieser Seite erhalten Sie einen Überblick über das Apps Script-Web-App-Beispiel für die Google Forms API.

Vorbereitung

  • Aktivieren Sie die Forms API in Ihrem Google Cloud-Projekt.
  • Richten Sie ein neues Apps Script-Projekt ein, wie in der GitHub-README-Datei für die Beispiel-Web-App beschrieben.

Übersicht

Mit der Forms API kann jeder authentifizierte Client direkt über REST auf die API zugreifen.

Da Apps Script eine einfache Möglichkeit bietet, sowohl ein gültiges OAuth-Zugriffstoken zu erhalten als auch REST-Aufrufe auszuführen, lässt sich Apps Script ganz einfach direkt in die Forms API einbinden. In Apps Script gibt es bereits einen Formulardienst, mit dem Scripts Google-Formulare erstellen, darauf zugreifen und sie ändern können. Wenn Sie die Forms API jedoch direkt über Apps Script verwenden möchten, richten Sie den OAuth-Zugriff so ein:

  1. Rufe ein OAuth-Zugriffstoken mit Bereich und Authentifizierung ab.

    ScriptApp.getOAuthToken();

  2. Fügen Sie das OAuth-Token in das Argument options ein, das in allen REST-Aufrufen an die API übergeben wird.

    UrlFetchApp.fetch(Url, options);

Ein Beispiel dafür finden Sie unter Apps Script-Projekt einrichten. Im Einrichtungsleitfaden werden die grundlegenden Funktionen beschrieben, die zum Aufrufen der API erforderlich sind. Wenn Sie Endnutzern jedoch einen intuitiven Zugriff auf die API ermöglichen möchten, können Sie auch unsere Beispiel-Web-App ausprobieren und ändern.

Beispiel für die Verwendung einer Webanwendung

Eine vollständige Beispiel-Web-App, die alle Methoden der Forms API direkt aufruft, ist zu Demonstrationszwecken auf GitHub verfügbar.

Webanwendung ausführen

Nachdem Sie Ihr Projekt eingerichtet und als Webanwendung bereitgestellt haben, können Sie einige grundlegende Vorgänge ausprobieren.

  1. Klicken Sie auf die Schaltfläche Formular erstellen, um ein neues Formular zu erstellen.

    Das neue Formular ist jetzt im Feld Formular-ID zu sehen. Sie können es öffnen, indem Sie auf In Google Formulare öffnen klicken.

  2. Öffnen Sie das neue Formular in einem separaten Fenster, fügen Sie einige Fragen manuell hinzu und klicken Sie dann auf Formular anhand der ID abrufen. Die neuen Fragen werden dann in der JSON-Ausgabe rechts angezeigt.

Sehen Sie sich die anderen in der App verfügbaren Methoden an und beobachten Sie die Ausgabe rechts für jeden Vorgang.

Mit Smartwatches für Google Formulare arbeiten

Beachten Sie auch die Schaltflächen für Formular-Smartwatches. Dabei wird die Funktion „Beobachtungen“ der Forms API verwendet und es werden grundlegende Vorgänge zum Erstellen, Auflisten, Löschen und Verlängern von Beobachtungen ausgeführt. Sie müssen ein Projekt mit Cloud Pub/Sub-Themen einrichten, um sie verwenden zu können.

Weitere Informationen zu Forms API-Wachtdiensten und Cloud Pub/Sub finden Sie unter Push-Benachrichtigungen einrichten und empfangen.

Nächste Schritte

Passen Sie die Beispiel-App an Ihre Anforderungen an. Hier einige Beispiele:

  • Erstellen Sie eine Fragendatenbank in einer Google-Tabelle und rufen Sie dann mit dem Apps Script-Dienst SpreadsheetApp Fragen aus einer Tabelle ab, um neue Formulare zu erstellen.
  • Alternativ kann sich Ihre Fragedatenbank in einer SQL-Datenbank befinden, in der Sie mit dem JDBC-Dienst von Apps Script Formulare mit Fragen aus der Datenbank füllen können.
  • Erstellen Sie ein Quiz und speichern Sie die Ergebnisse in einer Notenliste in Google Tabellen.
  • Richten Sie Ihr Projekt mit Cloud Pub/Sub ein und verwenden Sie die Funktion Uhren, um eine Echtzeit-Bestenliste für Schüler/Studenten zu generieren, in der die Quizergebnisse angezeigt werden.