谷歌表格操作

技能简介

本技能基于Node.js SDK连接Google Sheets API，支持对谷歌表格进行完整的数据操作与格式管理。通过服务账号认证，可实现跨平台、自动化的表格处理流程。

业务背景

业务人员可自动化处理谷歌表格数据，打通报表系统与在线协作的断点。通过API读写单元格、批量更新格式，替代手工复制粘贴，确保数据流转实时准确，支撑财务对账、运营看板等高频场景。

落地案例：运营部门每日需将CRM订单数据汇总至团队共享表格。技术人员配置Google Cloud服务账号后，使用Node.js SDK编写定时任务：读取A1:E100区域校验昨日数据，将新增订单以JSON格式追加写入末尾行，并标红异常金额单元格。财务次日打开表格即可直接审阅，无需等待人工导入。

能做什么

• 读取指定单元格区域的数据内容
• 写入或追加JSON格式的结构化数据
• 设置单元格背景色、字体样式、对齐方式
• 添加边框、合并/取消合并单元格
• 调整行列尺寸、冻结窗格
• 创建新表格、增删改工作表标签

使用说明

第一步：配置Google Cloud服务账号

1. 登录Google Cloud Console，创建或选择项目
2. 启用”Google Sheets API”服务
3. 进入IAM → 服务账号 → 创建服务账号
4. 下载JSON格式密钥文件

第二步：配置本地凭证（任选一种）

• 环境变量：GOOGLE_SERVICE_ACCOUNT_KEY=/path/to/key.json
• 将密钥文件重命名为service-account.json或credentials.json放入技能目录
• 放入系统配置目录：~/.config/google-sheets/credentials.json

第三步：共享表格权限

打开目标表格，点击”共享”，添加服务账号的邮箱地址（在JSON密钥的client_email字段中）。

第四步：安装依赖

cd skills/google-sheets && npm install

第五步：执行命令

# 读取数据
node scripts/sheets.js read "SPREADSHEET_ID" "Sheet1!A1:C10"

# 写入数据
node scripts/sheets.js write "SPREADSHEET_ID" "Sheet1!A1:B2" '[["Name","Score"],["Alice",95]]'

# 设置黄色背景加粗字体
node scripts/sheets.js format "SPREADSHEET_ID" "Sheet1!A1:B2" '{"backgroundColor":{"red":255,"green":255,"blue":0},"textFormat":{"bold":true}}'

表格ID可从URL中获取：https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

输入与输出

见下方输入与输出表格。

风险提示

• 服务账号需具备表格编辑权限，否则返回403错误
• 写入操作会直接覆盖目标区域，建议先备份重要数据
• JSON格式参数需严格符合API规范，引号转义易出错
• 频繁调用可能触发Google API速率限制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/longmaba/google-sheet/SKILL.md
来源类型：开源社区技能库