SuperAPI AI 工具集

managing-google-sheets

办公与效率

查看项目

更新于 10-15 21:53

技能介绍

用途:通过 sheets-cli 命令行工具对 Google Sheets 进行读取、写入和更新,适合用户要求读取表格数据、更新单元格、追加行或处理电子表格的场景。工具已安装并位于 PATH 中,可直接运行,无需安装。

主要能力:按名称查找表格(sheets-cli sheets find --name "Projects");列出工作表/标签页;读取表数据(read table,返回 headers、rows 及每行 _row 绝对行号);读取原始区域(read range);按关键列更新(update key,推荐,避免行位移影响);按行号更新(update row);追加行(append);设置区域(set range);批量操作(batch,支持 append、updateRow、updateKey、setRange)。

使用方式:遵循“读取 → 判断 → 试运行 → 应用”流程。先用 read table 了解当前状态,再用 --dry-run 预览,确认后去掉该参数执行。--spreadsheet 可接受 ID 或完整 URL。列名匹配不区分大小写并规范化空白。表头行可自动检测,无表头时列以 A、B 表示。空表可通过 append 用 JSON 键写入表头。所有命令返回 JSON,需检查 ok 字段。

限制与注意:按名称查找需项目启用 Google Drive API;按关键列更新若匹配多行会报错,除非加 --allow-multi;不要手动计算行号,应使用 read 输出中的 _row;写入前建议始终 dry-run。退出码:0 成功、10 校验错误、20 认证错误、30 权限错误、40 API/临时错误。认证命令为 sheets-cli auth login --credentials <oauth-client.json>,可用 auth status 查看状态。