Auf dieser Seite finden Sie eine Übersicht über das Beispiel für eine Apps Script-Webanwendung 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 README-Datei auf GitHub 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 sowohl ein gültiges OAuth-Zugriffstoken als auch REST-Aufrufe ermöglicht, kann Apps Script direkt in die Forms API eingebunden werden. Apps Script bietet bereits einen Forms Service, mit dem Skripts Formulare erstellen, darauf zugreifen und sie ändern können. Wenn Sie die Forms API jedoch lieber direkt über Apps Script verwenden möchten, richten Sie den OAuth-Zugriff so ein:
Rufen Sie ein authentifiziertes OAuth-Zugriffstoken mit Bereich ab.
ScriptApp.getOAuthToken();Fügen Sie das OAuth-Token in das options-Argument ein, das in allen REST-Aufrufen der API angegeben wird.
UrlFetchApp.fetch(Url, options);
Ein Beispiel dafür finden Sie unter Apps Script-Projekt einrichten. Im Einrichtungsleitfaden wird die Infrastruktur beschrieben, die für den Aufruf der API erforderlich ist. Um Nutzern einen intuitiven Zugriff auf die API zu ermöglichen, können Sie auch unsere Beispiel-Web-App ausprobieren und ändern.
Beispiel für die Verwendung einer Web-App
Eine vollständige Beispiel-Web-App, die alle Methoden der Forms API direkt aufruft, ist im GitHub-Repository apps-script-samples verfügbar.
Webanwendung ausführen
Nachdem Sie Ihr Projekt eingerichtet und als Web-App bereitgestellt haben, können Sie einige Vorgänge ausprobieren.
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.
Nachdem Sie das neue Formular in einem separaten Fenster geöffnet haben, fügen Sie einige Fragen manuell hinzu. Klicken Sie dann auf Get Form by Id (Formular anhand der ID abrufen). Die neuen Fragen werden rechts in der JSON-Ausgabe angezeigt.
Sehen Sie sich die anderen in der App verfügbaren Methoden an und beobachten Sie die Ausgabe rechts für jeden Vorgang.
Mit Google Formulare auf Smartwatches arbeiten
Beachten Sie auch die Schaltflächen für Formulare für Smartwatches. Dabei wird die Funktion „Beobachtungen“ der Forms API verwendet und es werden Vorgänge zum Erstellen, Auflisten, Löschen und Erneuern 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-Beobachtungen und Cloud Pub/Sub finden Sie unter Push-Benachrichtigungen einrichten und empfangen.
Nächste Schritte
Passen Sie die Beispiel-App an Ihre Bedürfnisse an. Hier einige Beispiele:
- Erstellen Sie eine Fragensammlung in einer Google-Tabelle und verwenden Sie dann den Apps Script-Dienst SpreadsheetApp, um Fragen aus einer Tabelle abzurufen und neue Formulare damit zu füllen.
- Alternativ kann sich Ihre Fragensammlung in einer SQL-Datenbank befinden. Dort können Sie den Apps Script-JDBC-Dienst verwenden, um Formulare mit Fragen aus der Datenbank zu füllen.
- Ein Quiz erstellen und die Ergebnisse in einer Google-Tabelle speichern
- Richten Sie Ihr Projekt mit Cloud Pub/Sub ein und verwenden Sie die Funktion watches, um eine Schüler-Bestenliste in Echtzeit zu erstellen, in der die Quiz-Ergebnisse angezeigt werden.