SuperAPI AI 工具集

google-sheets

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

用途:通过命令行脚本与 Google Sheets 交互,完成表格创建、数据读写、公式操作等电子表格管理与数据操作任务。

主要能力:检查配置与连通性(check);存储 OAuth 2.0 客户端凭据(auth setup)、重置令牌(auth reset)、查看令牌状态(auth status);创建表格(spreadsheets create,可指定标题与工作表名)、获取表格元数据与结构(spreadsheets get);读取区域值(values read,支持 FORMATTED_VALUE、UNFORMATTED_VALUE、FORMULA 三种格式)、写入值(values write,值为 JSON 二维数组,公式以 = 开头)、追加行(values append)、清除区域值(values clear);新增工作表(sheets create)和删除工作表(sheets delete,需用数字 sheet ID 而非标题)。

使用方式:先安装依赖 pip install --user google-auth google-auth-oauthlib google-api-python-client keyring pyyaml;创建 ~/.config/agent-skills/google.yaml 填入 oauth_client 的 client_id 与 client_secret;运行 $SKILL_DIR/scripts/google-sheets.py check 触发 OAuth 流程并验证。所有命令均以 $SKILL_DIR/scripts/google-sheets.py 开头,如 values read SPREADSHEET_ID --range "Sheet1!A1:D5"。区域采用 A1 记法,含空格的工作表名需加引号。

适用场景:需要以脚本或智能体方式批量创建表格、写入或追加数据、读取公式与计算值、管理多工作表结构的自动化流程。

限制:认证基于 OAuth 2.0,需要浏览器完成授权;权限不足、认证或作用域错误不可重试,须由用户处理;限流(HTTP 429)与临时服务器错误(HTTP 5xx)可稍后重试;必须使用正确的 spreadsheet ID;values clear 不会清除受保护单元格;不能删除表格中最后一个工作表;资料未提供图表与数据透视表的具体命令细节,官方正文中亦暂未提供。