用途:通过 gws 命令行读写 Google Sheets 电子表格,属于 gws-cli 技能集的一部分。
主要能力:提供辅助命令 +append(向表格追加一行)和 +read(读取表格中的值);spreadsheets 资源支持 batchUpdate(批量应用更新,任一请求无效则整体失败)、create(创建表格并返回新表格)、get(按 ID 返回表格,默认不返回网格数据,可用 fields 参数或 includeGridData=true 获取)、getByDataFilter(按 dataFilters 选择返回的数据子集),以及 developerMetadata、sheets、values 等子资源操作。
使用方式:先阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则;若缺失,运行 gws generate-skills 生成。命令格式为 gws sheets <resource> <method> [flags]。调用前可用 gws sheets --help 浏览资源与方法,用 gws schema sheets.<resource>.<method> 查看必填参数、类型和默认值,再据此构建 --params 和 --json 标志。
适用场景:需要在命令行或自动化流程中读取、追加、批量更新 Google Sheets 数据时使用。
限制:依赖 gws-shared 的认证与安全配置;batchUpdate 为全有或全无,任一请求无效则全部不应用;get 默认不返回网格数据,需显式指定字段或 includeGridData。具体认证方式、配额与错误处理细节暂未提供。