name: gws-forms
description: 读写 Google Forms。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws forms --help"

forms (v1)

前置条件： 阅读 ../gws-shared/SKILL.md 了解身份验证、全局标志和安全规则。若缺失，请运行 gws generate-skills 创建。

gws forms <资源> <方法> [flags]

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.<资源>.<方法>

使用 gws schema 输出来构建您的 --params 和 --json 标志。