Na tej stronie znajdziesz omówienie przykładowej aplikacji internetowej Apps Script dla Google Forms API.
Wymagania wstępne
- włączyć interfejs Forms API w projekcie Google Cloud,
- Skonfiguruj nowy projekt Apps Script zgodnie z opisem w pliku README na GitHubie przykładowej aplikacji internetowej.
Przegląd
Interfejs Forms API umożliwia każdemu uwierzytelnionemu klientowi bezpośredni dostęp do interfejsu API za pomocą REST.
Skrypty Google Apps Script umożliwiają uzyskanie prawidłowego tokena dostępu OAuth i wykonywanie wywołań REST, dlatego można je zintegrować bezpośrednio z interfejsem Forms API. Apps Script udostępnia już usługę Formularze, która umożliwia skryptom tworzenie formularzy oraz uzyskiwanie do nich dostępu i ich modyfikowanie. Jeśli jednak wolisz korzystać z interfejsu API Formularzy bezpośrednio w Apps Script, skonfiguruj dostęp OAuth w ten sposób:
Uzyskaj token dostępu OAuth z określonym zakresem i uwierzytelnieniem.
ScriptApp.getOAuthToken();Dołącz token OAuth do argumentu options podanego w dowolnym wywołaniu REST interfejsu API.
UrlFetchApp.fetch(Url, options);
Przykład znajdziesz w artykule Konfigurowanie projektu Apps Script. Przewodnik po konfiguracji zawiera szczegółowe informacje o infrastrukturze potrzebnej do wywoływania 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łady użycia aplikacji internetowej
Kompletna przykładowa aplikacja internetowa, która wywołuje wszystkie metody interfejsu Forms API bezpośrednio, jest dostępna w apps-script-samplesrepozytorium GitHub.
Uruchamianie aplikacji internetowej
Po skonfigurowaniu projektu i wdrożeniu go jako aplikacji internetowej możesz wypróbować niektóre operacje.
Utwórz nowy formularz, klikając 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 osobnym oknie spróbuj ręcznie dodać kilka pytań, a następnie kliknij Get Form by Id (Pobierz formularz według identyfikatora). Po prawej stronie w danych wyjściowych JSON zobaczysz nowe pytania.
Wypróbuj inne metody dostępne w aplikacji i obserwuj wyniki każdej operacji po prawej stronie.
Korzystanie z zegarków z Formularzami
Zwróć też uwagę na przyciski dotyczące formularzy na zegarkach. Korzystają one z funkcji obserwowania interfejsu Forms API i wykonują operacje tworzenia, wyświetlania, usuwania i odnawiania obserwacji. Aby z nich korzystać, musisz skonfigurować projekt z tematami Cloud Pub/Sub.
Więcej informacji o obserwowaniu interfejsu Forms API i usłudze Cloud Pub/Sub znajdziesz w artykule Konfigurowanie i otrzymywanie 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 SpreadsheetApp w Apps Script, aby pobrać pytania z arkusza i wypełnić nimi nowe formularze.
- Możesz też umieścić bank pytań w bazie danych SQL, w której możesz użyć usługi JDBC Apps Script, aby wypełniać formularze pytaniami z bazy danych.
- Wygeneruj test i zapisz wyniki w dzienniku ocen w Arkuszach Google.
- Skonfiguruj projekt za pomocą Cloud Pub/Sub i użyj funkcji watches, aby wygenerować w czasie rzeczywistym tablicę wyników uczniów, na której będą wyświetlane wyniki quizu.