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