核心用法
gws-forms 是基于 Google Workspace CLI (gws) 的表单管理技能,提供对 Google Forms API 的完整封装。主要功能包括:
- 表单创建:通过
forms.create快速生成空表单(仅支持标题字段) - 批量更新:使用
forms.batchUpdate添加题目、修改设置、配置发布选项 - 数据读取:
forms.get获取表单结构,forms.responses拉取提交数据 - 监控管理:
forms.watches设置事件监听,实时追踪表单活动
操作前需先阅读 ../gws-shared/SKILL.md 完成 OAuth 认证配置,所有命令遵循 gws forms <resource> <method> 的统一模式,支持 --params 和 --json 参数注入。
显著优点
1. 原子化操作:batchUpdate 机制确保复杂修改的事务一致性
2. Schema 驱动:内置 gws schema 命令,降低 API 学习成本
3. 响应集成:直接对接表单数据,无需额外 ETL 流程
潜在局限
- 创建限制:
forms.create仅复制标题字段,完整表单需二次调用 update - 遗留兼容:不支持旧版表单的
publish_settings更新 - CLI 依赖:需预装
gws二进制文件,增加部署复杂度
适合人群
DevOps 工程师、数据分析师、需要批量处理 Google Forms 的企业 IT 团队,以及构建表单自动化工作流的开发者。
常规风险
OAuth 凭据管理不当可能导致数据泄露;批量操作前建议通过 gws schema 验证参数类型,避免 API 调用失败。