Na tej stronie znajdziesz omówienie przykładowej aplikacji internetowej Google Apps Script dla interfejsu Google Forms API.
Wymagania wstępne
- Włącz interfejs Forms API w projekcie Google Cloud.
- Skonfiguruj nowy projekt Apps Script zgodnie z instrukcjami podanymi w pliku README na GitHubie dotyczącym przykładowej aplikacji internetowej.
Omówienie
Interfejs Forms API umożliwia każdemu uwierzytelnionemu klientowi bezpośredni dostęp do interfejsu API za pomocą protokołu REST.
Aplikacja Apps Script ułatwia uzyskiwanie prawidłowego tokena dostępu OAuth i wywoływanie interfejsów REST, więc integracja aplikacji Apps Script bezpośrednio z interfejsem Forms API jest bardzo prosta. Apps Script udostępnia już usługę Formularzy, która umożliwia tworzenie, uzyskiwanie dostępu do formularzy Google i ich modyfikowanie. Jeśli jednak wolisz korzystać z interfejsu API Formularzy bezpośrednio z Google Apps Script, skonfiguruj dostęp OAuth w ten sposób:
Uzyskaj ograniczony i uwierzytelniony token dostępu OAuth.
ScriptApp.getOAuthToken();Dołącz token OAuth do argumentu options w dowolnych wywołaniach REST interfejsu API.
UrlFetchApp.fetch(Url, options);
Przykład takiego działania znajdziesz w artykule Konfigurowanie projektu Apps Script. Przewodnik po konfiguracji zawiera szczegółowe informacje o podstawowych elementach potrzebnych do wywołania interfejsu API. Aby jednak zapewnić użytkownikom intuicyjny dostęp do interfejsu API, możesz też wypróbować i zmodyfikować naszą przykładową aplikację internetową.
Przykład użycia aplikacji internetowej
Pełna przykładowa aplikacja internetowa, która bezpośrednio wywołuje wszystkie metody interfejsu Forms API, jest dostępna na GitHub w celu demonstracji.
Uruchamianie aplikacji internetowej
Po skonfigurowaniu projektu i wdrożeniu go jako aplikacji internetowej możesz wypróbować kilka podstawowych operacji.
Aby utworzyć nowy formularz, kliknij przycisk Utwórz formularz.
Nowy formularz jest teraz widoczny w polu Identyfikator formularza: możesz go otworzyć, klikając Otwórz w Formularzach.
Po otwarciu nowego formularza w oddzielnym oknie spróbuj ręcznie dodać kilka pytań, a potem kliknij Pobierz formularz według identyfikatora. Nowe pytania zobaczysz w wyjściu w formacie JSON po prawej stronie.
Zapoznaj się z innymi metodami dostępnymi w aplikacji i obserwuj dane wyjściowe po prawej stronie dla każdej operacji.
Praca z zegarkami w Formularzach
Zwróć też uwagę na przyciski formularzy zegarków. Korzystają one z funkcji obserwowania interfejsu Forms API i wykonują podstawowe operacje tworzenia, wyświetlania, usuwania i odnawiania obserwacji. Aby z nich korzystać, musisz skonfigurować projekt z tematami Cloud Pub/Sub.
Więcej informacji o obsłudze interfejsu Forms API i usługi Cloud Pub/Sub znajdziesz w artykule Konfigurowanie i odbieranie powiadomień push.
Dalsze kroki
Spróbuj dostosować przykładową aplikację do swoich potrzeb. Oto kilka przykładów:
- Utwórz bank pytań w arkuszu Google, a następnie użyj usługi Apps Script SpreadsheetApp, aby pobrać pytania z arkusza i wypełnić nimi nowe formularze.
- Bank pytań może też znajdować się w bazie danych SQL, w której możesz używać usługi JDBC w Apps Script, aby wypełniać formularze pytaniami z tej bazy danych.
- Wygeneruj test i zapisz wyniki w zeszycie ocen w Arkuszach Google.
- Skonfiguruj projekt za pomocą Cloud Pub/Sub i użyj funkcji oglądalności, aby wygenerować tablicę wyników uczniów w czasie rzeczywistym, która wyświetla wyniki quizu.