用途
gws-sheets-append 是 Google Workspace CLI 中的 Google Sheets 写入命令，用于向指定电子表格追加数据行。它适合在脚本或命令行流程中快速写入表格内容。
主要能力
- 向指定电子表格（由 --spreadsheet 指定 ID）追加行数据。
- 支持以逗号分隔的简单字符串追加单行（--values）。
- 支持以 JSON 数组形式批量追加多行（--json-values）。
- 支持通过 A1 记法指定目标工作表标签（--range），默认 A1，即第一个工作表。
使用方式
命令格式：
gws sheets +append --spreadsheet <ID>
参数说明：
- --spreadsheet（必填）：电子表格 ID。
- --values：逗号分隔的值（简单字符串）。
- --json-values：JSON 数组形式的多行数据，例如 '[["a","b"],["c","d"]]'。
- --range：A1 记法中的目标范围（例如 'Sheet2!A1'），用于选择特定工作表标签，默认 A1。
使用前需先阅读 ../gws-shared/SKILL.md 以了解认证、全局标志与安全规则；如果该文件缺失，运行 gws generate-skills 生成。
示例：
gws sheets +append --spreadsheet ID --values 'Alice,100,true'
gws sheets +append --spreadsheet ID --json-values '[["a","b"],["c","d"]]'
gws sheets +append --spreadsheet ID --range "Sheet2!A1" --values 'Alice,100'
使用提示
- 简单的单行追加使用 --values。
- 批量多行插入使用 --json-values。
- 追加到特定工作表标签使用 --range（默认 A1，即第一个工作表）。
限制与注意事项
此命令为写命令，执行前需与用户确认。关于认证细节、全局标志与更完整的安全规则，请参见 gws-shared；关于读取和写入电子表格的全部命令，请参见 gws-sheets。