核心用法
gws-forms 是 Google Workspace CLI（gws）生态的表单管理插件，通过命令行接口实现 Google Forms 的全生命周期操作。核心命令结构为 gws forms <resource> <method> [flags]，支持六大资源维度：
- forms：创建表单（
create）、获取详情（get）、批量更新（batchUpdate）、发布设置（setPublishSettings） - responses：管理表单响应数据
- watches：配置表单变更监听
关键约束：create 仅复制标题字段，需二次调用 update 添加题目；setPublishSettings 不支持旧版表单。
前置依赖：必须预先配置 gws 全局认证（OAuth2），并阅读 ../gws-shared/SKILL.md 获取安全规则与全局参数。
显著优点
- 自动化友好：CLI 接口便于集成 CI/CD 流水线，批量创建调研问卷、考试表单
- 细粒度操作：
batchUpdate支持原子化批量修改，避免多次 API 调用 - Schema 自省：
gws schema命令实时暴露 API 参数类型，降低开发试错成本 - 生态整合：与 Google Workspace 其他服务（Sheets、Drive）共享认证体系
潜在缺点与局限性
- 两步创建限制：无法单次请求完成「创建+配置」，必须串行调用 API
- 旧版兼容缺口：
publish_settings相关功能不兼容历史表单 - 认证门槛高：依赖企业级 Google Workspace 账号及管理员配置的 OAuth 凭据
- 无交互式界面：纯 CLI 工具，非技术用户学习曲线陡峭
适合人群
- 需要批量管理成百上千表单的教育机构 IT 管理员
- 构建内部表单自动化平台的 SaaS 开发者
- 将 Google Forms 嵌入数据管道的数据工程师
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | `responses` 操作可能拉取敏感用户数据，需严格限制 OAuth 范围 |
| 误操作覆盖 | `batchUpdate` 无预览模式，错误 payload 可导致表单结构损毁 |
| 权限蔓延 | 共享的 `gws` 凭据若未按最小权限原则配置，存在横向越权风险 |
建议生产环境启用 GCP Audit Logs 监控 forms 相关 API 调用，并定期轮换 OAuth 令牌。