本页面简要介绍了 Google Forms API 的 Apps Script Web 应用示例。
前提条件
- 在您的 Google Cloud 项目中启用 Google 表单 API。
- 按照GitHub README 文件中的说明为示例 Web 应用设置一个新的 Apps 脚本项目。
概览
借助 Google 表单 API,任何经过身份验证的客户端都可以直接使用 REST 访问该 API。
由于 Apps Script 提供了一种简单的方法来获取有效的 OAuth 访问令牌并进行 REST 调用,因此可以轻松地将 Apps Script 直接与 Google 表单 API 集成。Apps 脚本已提供现有的 Google 表单服务,可让脚本创建、访问和修改 Google 表单。不过,如果您想直接从 Apps 脚本使用 Google 表单 API,请按如下方式设置 OAuth 访问权限:
获取经过身份验证且具有范围限定的 OAuth 访问令牌。
ScriptApp.getOAuthToken();
在对该 API 的任何 REST 调用中提供的 options 参数中添加 OAuth 令牌。
UrlFetchApp.fetch(Url, options);
如需查看此操作的示例,请参阅设置 Apps 脚本项目。设置指南详细介绍了调用 API 所需的基本管道,不过,为了向最终用户提供对 API 的直观访问方式,您还可以试用和修改我们的示例 Web 应用。
Web 应用示例用法
GitHub 上提供了一个完整的示例 Web 应用,用于演示直接调用所有 Forms API 方法。
运行 Web 应用
设置项目并将其部署为 Web 应用后,您可以尝试执行一些基本操作。
点击创建表单按钮,创建新表单。
新表单现在会显示在表单 ID 字段中,您可以点击在 Google 表单中打开来打开该表单。
在单独的窗口中打开新表单后,尝试手动添加几个问题,然后点击按 ID 获取表单,您会在右侧的 JSON 输出中看到新问题。
您可以随意探索该应用中提供的其他方法,并观察右侧每项操作的输出。
使用 Google 表单监视器
另请注意表单监视器的按钮。这些脚本使用 Google 表单 API 的“监控”功能,执行创建、列出、删除和续订监控的基本操作。您需要设置一个包含 Cloud Pub/Sub 主题的项目,才能使用这些主题。
如需详细了解 Forms API 监视器和 Cloud Pub/Sub,请参阅设置和接收推送通知。
后续步骤
尝试自定义示例应用以满足您的需求。以下是几个例子:
- 在 Google 表格中创建题库,然后使用 Apps 脚本 SpreadsheetApp 服务从表格中提取题目以填充新表单。
- 或者,您的题库也可以位于 SQL 数据库中,您可以在其中使用 Apps Script JDBC 服务将数据库中的题目填充到表单中。
- 生成测验并将成绩保存到 Google 表格成绩册中。
- 使用 Cloud Pub/Sub 设置您的项目,并使用监视功能生成实时学生排行榜以显示知识问答结果。