name: gws-sheets
description: 'Google Sheets: 读取和写入电子表格。'
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws sheets --help"

sheets (v4)

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

gws sheets <resource> <method> [flags]

辅助命令

API 资源

spreadsheets

• batchUpdate — 对电子表格应用一个或多个更新。每个请求在应用前都会经过验证。如果任何请求无效，则整个请求将失败且不会应用任何更新。部分请求会返回答复，以提供其应用方式的相关信息。这些答复将镜像请求的顺序。例如，如果你应用了 4 个更新，且第 3 个更新有答复，则响应将依次包含 2 个空答复、实际答复以及另一个空答复。
• create — 创建电子表格，并返回新建的电子表格。
• get — 返回指定 ID 的电子表格。调用者必须指定电子表格 ID。默认情况下，不返回网格内的数据。你可以通过以下两种方式之一包含网格数据：* 使用 fields URL 参数指定一个字段掩码列出所需字段 * 将 includeGridData URL 参数设为 true。
• getByDataFilter — 返回指定 ID 的电子表格。调用者必须指定电子表格 ID。更多信息请参阅读取、写入和搜索元数据。此方法与 GetSpreadsheet 的不同之处在于，它允许通过指定 dataFilters 参数来选择返回电子表格数据的子集。可指定多个 DataFilter。
• developerMetadata — 对 'developerMetadata' 资源的操作
• sheets — 对 'sheets' 资源的操作
• values — 对 'values' 资源的操作

发现命令

在调用任何 API 方法之前，请先检查它：

# 浏览资源和方法
gws sheets --help

# 检查方法的必填参数、类型和默认值
gws schema sheets.<resource>.<method>

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