gws-forms 是 gws-claude-plugin 插件中的一个技能,用于通过命令行读写 Google Forms(表单)。其命令形式为:gws forms <resource> <method> [flags]。
用途 该技能面向需要在命令行环境中操作 Google Forms 的用户,可用于创建表单、读取表单内容、批量修改表单,以及管理表单的发布设置和回复相关资源。
前置条件 使用前需阅读 ../gws-shared/SKILL.md,以了解认证方式、全局参数和安全规则。如果该文件缺失,可运行 gws generate-skills 来生成。
主要能力(API 资源与方法) forms 资源提供以下方法:
- batchUpdate:通过一批更新来更改表单。
- create:使用请求中提供的表单消息里的标题创建新表单。需要注意:只有 form.info.title 和 form.info.document_title 字段会被复制到新表单,其他字段(包括表单描述、条目和设置)都不允许。若要创建新表单并添加条目,必须先调用 forms.create 创建一个带标题(以及可选文档标题)的空表单,然后再调用 forms.update 添加条目。
- get:获取一个表单。
- setPublishSettings:更新表单的发布设置。旧版表单不受支持,因为它们没有 publish_settings 字段。 此外还有两个子资源:
- responses:对“responses”资源的操作。
- watches:对“watches”资源的操作。
使用方式 在调用任何 API 方法之前,建议先检查该方法:
- 浏览资源和方法:gws forms --help
- 查看某个方法所需的参数、类型和默认值:gws schema forms.<resource>.<method> 然后根据 gws schema 的输出构建 --params 和 --json 参数。
适用场景 适合需要在命令行或自动化脚本中管理 Google 表单的场景,例如创建表单、读取表单结构、批量更新表单内容、调整发布设置,以及处理表单回复和监视配置。
限制
- 使用前必须完成 gws-shared 中的认证与安全配置。
- create 方法仅复制标题和文档标题,其他字段不允许,需分两步创建表单并添加条目。
- setPublishSettings 不支持旧版表单。
- 关于 responses 和 watches 子资源的具体方法细节,资料中未提供,需通过 gws forms --help 或 gws schema 进一步查看。