Apps 脚本示例 Web 应用

本页面简要介绍了 Google Form API 的 Apps 脚本 Web 应用示例。

前提条件

  • 在 Google Cloud 项目中启用 Form API。
  • 按照示例 Web 应用的 GitHub README 文件所述,设置一个新的 Apps 脚本项目。

概览

Form API 允许任何经过身份验证的客户端使用 REST 直接访问 API。

由于 Apps 脚本可让您轻松获取有效的 OAuth 访问令牌并进行 REST 调用,因此将 Apps 脚本与 Form API 直接集成非常简单。Apps 脚本已提供现有的 Google 表单服务,该服务可让脚本创建、访问和修改 Google 表单。但是,如果您希望直接从 Apps 脚本使用 Forms API,请按如下方式设置 OAuth 访问权限:

  1. 获取限定了作用域且经过身份验证的 OAuth 访问令牌。

    ScriptApp.getOAuthToken();

  2. 在对 API 的任何 REST 调用中提供的 options 参数中添加 OAuth 令牌。

    UrlFetchApp.fetch(Url, options);

如需查看实际操作示例,请参阅设置 Apps 脚本项目。设置指南详细介绍了调用该 API 所需的基本管道。不过,为了让最终用户能够直观地访问该 API,您还可以试用并修改我们的示例 Web 应用。

Web 应用用法示例

为便于演示,GitHub 上提供了一个直接调用所有 Form API 方法的完整示例 Web 应用。

运行 Web 应用

设置项目并将其部署为 Web 应用后,您可以尝试一些基本操作。

  1. 点击 Create Form 按钮以创建新表单。

    新表单现在显示在 Form id: 字段中,您可以点击 Open in Form 将其打开。

  2. 在单独的窗口中打开新表单后,尝试手动添加一些问题,然后点击 Get Form by Id,您会在右侧的 JSON 输出中看到新问题。

您可以随意探索应用中可用的其他方法,并观察每项操作右侧的输出。

使用 Google 表单手表

另请注意表单手表的按钮。这些 API 使用 Forms API 监控功能并执行创建、列出、删除和续订手表的基本操作。您需要设置一个具有 Cloud Pub/Sub 主题的项目才能使用它们。

如需详细了解 Form API 手表和 Cloud Pub/Sub,请参阅设置和接收推送通知

后续步骤

请尝试根据您的需求自定义示例应用。以下是几个示例:

  • 在 Google 表格中创建问题库,然后使用 Apps 脚本 SpreadsheetApp 服务从工作表中提取问题,以填充新表单。
  • 或者,您可以将问题库存储在 SQL 数据库中,在该数据库中,您可以使用 Apps 脚本 JDBC 服务使用数据库中的问题填充表单。
  • 生成测验并将分数保存在 Google 成绩册中。
  • 使用 Cloud Pub/Sub 设置项目,并使用 watches 功能生成实时学生排行榜,以显示测验结果。