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 参数指定一个 字段掩码，列出您想要的字段 * 将 URL 参数 includeGridData 设置为 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 标志。