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 <resource> <method> [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.<resource>.<method>

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