Na tej stronie znajdziesz omówienie przykładowej aplikacji internetowej Apps Script dla interfejsu Google Formularzy API.
Wymagania wstępne
- włączyć interfejs Formularzy API w projekcie Google Cloud;
- Skonfiguruj nowy projekt Apps Script zgodnie z opisem w pliku README GitHuba dla przykładowej aplikacji internetowej.
Przegląd
Formularze API pozwalają każdemu uwierzytelnionemu klientowi uzyskać bezpośredni dostęp do interfejsu API za pomocą REST.
Apps Script ułatwia uzyskanie prawidłowego tokena dostępu OAuth i wykonywanie wywołań REST, dlatego możesz łatwo zintegrować Apps Script bezpośrednio z interfejsem Formularzy API. Apps Script udostępnia już istniejącą usługę Formularzy, która umożliwia skryptom tworzenie, dostęp i modyfikowanie formularzy Google. Jeśli jednak wolisz używać interfejsu Formularzy API bezpośrednio z poziomu Apps Script, skonfiguruj dostęp OAuth w ten sposób:
Pobierz ograniczony i uwierzytelniony token dostępu OAuth.
ScriptApp.getOAuthToken();Token OAuth musisz umieścić w argumencie options w wywołaniach REST interfejsu API.
UrlFetchApp.fetch(Url, options);
Przykład znajdziesz w artykule o konfigurowaniu projektu Apps Script. W przewodniku konfiguracji opisujemy podstawowe działania hydrauliczne służące 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ładowa aplikacja internetowa
Kompletna przykładowa aplikacja internetowa, która bezpośrednio wywołuje wszystkie metody interfejsu Formularzy API, jest dostępna w celach demonstracyjnych na GitHub.
Uruchamianie aplikacji internetowej
Po skonfigurowaniu projektu i wdrożeniu go jako aplikacji internetowej możesz wypróbować kilka podstawowych operacji.
Utwórz nowy formularz, klikając przycisk Utwórz formularz.
Nowy formularz jest teraz widoczny w polu Identyfikator formularza: i możesz go otworzyć, klikając Otwórz w Formularzach.
Po otwarciu nowego formularza w osobnym oknie spróbuj dodać kilka pytań ręcznie, a następnie kliknij Pobierz formularz według identyfikatora. Nowe pytania wyświetlą się w danych wyjściowych JSON po prawej stronie.
Możesz też zapoznać się z innymi metodami dostępnymi w aplikacji i sprawdzić wyniki po prawej stronie każdej operacji.
Praca z zegarkami w Formularzach
Zwróć też uwagę na przyciski zegarków formularzy. Korzystają one z funkcji zegarków interfejsu Forms API i wykonują podstawowe operacje w zakresie tworzenia, wyświetlania, usuwania i odnawiania zegarków. Aby korzystać z tematów, musisz skonfigurować projekt z tematami Cloud Pub/Sub.
Więcej informacji o zegarkach interfejsu Formularzy API i Cloud Pub/Sub znajdziesz w artykule na temat konfigurowania i odbierania 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 w celu wypełnienia nowych formularzy.
- Bank pytań może się też znajdować w bazie danych SQL, w której możesz używać usługi Apps Script do wypełniania formularzy pytaniami z bazy danych.
- Wygeneruj test i zapisz wyniki w dzienniku ocen Google.
- Skonfiguruj projekt w Cloud Pub/Sub i użyj funkcji zegarków, aby wygenerować w czasie rzeczywistym tabelę wyników uczniów, na której będą wyświetlane wyniki testu.