SuperAPI AI 工具集

gws-forms

办公与效率

查看项目

更新于 10-16 04:16

技能介绍

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 进一步查看。