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