SuperAPI AI 工具集

google_sheets

通用与其它

查看项目

更新于 10-15 18:37

技能介绍

用途:通过 hatch_gws_cli(内置的 Google Workspace CLI)管理用户的 Google Sheets,这是唯一实现路径。

主要能力:查询连接状态与断开连接;创建表格、读取单元格、追加数据、批量更新;可用 schema 查看方法契约,也提供 +read、+append 等辅助命令。

使用方式:用 exec 运行 hatch_gws_cli sheets <resource> <method> [flags]。首次使用先运行 hatch_gws_cli sheets status;若不可用则告知用户本设备不支持,不要提供替代方案或索要凭据;若为 not_connected 且返回 connect_url,则以 Markdown 链接 Connect Google Sheets 形式分享并等待用户连接。写入时用 spreadsheets.create、values.update 或 values.append,并将 valueInputOption 设为 USER_ENTERED;样式通过一次 spreadsheets.batchUpdate 设置。读取时 spreadsheets.get 默认不返回单元格数据,需传 fields 掩码。断开连接运行 hatch_gws_cli sheets disconnect,并按返回的 disconnect_url 以 Markdown 链接分享。

限制与规则:不要用 drive files update 上传 .xlsx 覆盖表格,以免丢弃其他标签页和用户编辑;不要手写凭据文件或运行原始 gws auth。编辑共享表格前需确认。表格 ID 与工作表 ID 视为不透明字符串,仅使用命令返回或用户明确提供的值。不要在用户可见文本中暴露原始 API 标识符或内部响应字段,除非用户要求或用于排障。