用途:从 Google Sheets 电子表格中读取指定范围的数值,属于 gws 命令行工具集的 sheets 子命令,操作只读,不会修改表格内容。
前置条件:使用前需先阅读 ../gws-shared/SKILL.md,了解认证方式、全局标志和安全规则;若该文件缺失,运行 gws generate-skills 生成。
用法:gws sheets +read --spreadsheet <ID> --range <RANGE>
参数:--spreadsheet 必填,为电子表格 ID;--range 必填,为读取范围,例如 'Sheet1!A1:B2'。
示例:gws sheets +read --spreadsheet ID --range 'Sheet1!A1:D10';gws sheets +read --spreadsheet ID --range Sheet1。
提示:该命令为只读,绝不修改电子表格;如需高级选项,可使用原始 values.get API。相关命令参见 gws-shared(全局标志与认证)和 gws-sheets(所有读写电子表格命令)。
限制:资料未提供认证细节、配额、错误处理、返回格式及平台支持等信息。