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。默认情况下，不会返回网格中的数据。您可以通过以下两种方式之一包含网格数据：* 使用 HTTP 中的 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 标志。