На этой странице представлен обзор примера веб-приложения Apps Script для работы с API Google Forms.
Предварительные требования
- Включите API форм в своем проекте Google Cloud.
- Создайте новый проект Apps Script, как описано в файле README на GitHub для примера веб-приложения.
Обзор
API форм позволяет любому авторизованному клиенту получать прямой доступ к API с помощью REST .
Поскольку Apps Script предоставляет способ получения как действительного токена доступа OAuth, так и выполнения REST-запросов, возможна прямая интеграция Apps Script с Forms API. Apps Script уже предоставляет существующий сервис Forms , который позволяет скриптам создавать, получать доступ и изменять формы. Однако, если вы предпочитаете использовать Forms API непосредственно из Apps Script, настройте доступ OAuth следующим образом:
Получите аутентифицированный токен доступа OAuth с заданными областями действия.
ScriptApp.getOAuthToken();Включите токен OAuth в аргумент options , предоставляемый во всех REST-запросах к API.
UrlFetchApp.fetch(Url, options);
Пример работы можно посмотреть в разделе «Настройка проекта Apps Script» . В руководстве по настройке подробно описана инфраструктура, необходимая для вызова API, однако, чтобы обеспечить интуитивно понятный доступ к API для пользователей, вы также можете попробовать и модифицировать наше тестовое веб-приложение.
Пример использования в веб-приложении
Полный пример веб-приложения, которое напрямую вызывает все методы Forms API, доступен в репозитории apps-script-samples на GitHub .
Запуск веб-приложения
После того как вы настроили свой проект и развернули его как веб-приложение, вы можете попробовать выполнить некоторые операции.
Создайте новую форму, нажав кнопку «Создать форму» .
Новая форма теперь отображается в поле "Идентификатор формы:" , и вы можете открыть ее, нажав кнопку "Открыть в формах" .
После открытия новой формы в отдельном окне попробуйте добавить несколько вопросов вручную, затем нажмите «Получить форму по идентификатору» , и вы увидите новые вопросы в JSON-выводе справа.
Изучите другие методы, доступные в приложении, и понаблюдайте за результатом каждой операции справа.
Работа с часами Forms
Обратите внимание также на кнопки для отслеживания изменений в формах. Они используют функцию отслеживания изменений в API форм и выполняют операции по созданию, отображению, удалению и продлению отслеживаемых изменений. Для их использования необходимо настроить проект с темами Cloud Pub/Sub .
Для получения дополнительной информации о мониторинге Forms API и Cloud Pub/Sub см. раздел «Настройка и получение push-уведомлений» .
Следующие шаги
Попробуйте настроить пример приложения под свои нужды. Вот несколько примеров:
- Создайте базу вопросов в таблице Google Sheets, а затем используйте сервис SpreadsheetApp из Apps Script для получения вопросов из таблицы и заполнения новых форм.
- В качестве альтернативы, ваш банк вопросов может храниться в базе данных SQL, где вы можете использовать службу JDBC Apps Script для заполнения форм вопросами из базы данных.
- Создайте тест и сохраните результаты в электронной таблице Google Sheets.
- Настройте свой проект с помощью Cloud Pub/Sub и используйте функцию отслеживания результатов , чтобы создать таблицу лидеров среди студентов в режиме реального времени и отображать результаты викторины.