Agent Skills
返回列表
📁

Google 表格 curl 读写

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/acedatacloud-skills-google-sheets。

技能介绍

要解决什么问题

在自动化或 AI 助手会话里,你往往只有 curl 和 jq,却要读写线上 Google 表格、新建工作簿或增加标签页。浏览器 OAuth 没法直接塞进脚本链路,而 REST 又要求正确的 Bearer、表格 ID 和 A1 记法。这个技能把 Sheets v4 的调用方式写成固定约定,减少「查文档猜参数」的次数。

技能如何工作

所有请求发往 https://sheets.googleapis.com/v4/spreadsheets,请求头带 Authorization: Bearer $GOOGLE_SHEETS_TOKEN。表格 ID 取自分享链接里 /d/{spreadsheetId}/edit 那一段。

核心能力:

  • 读 / 追加 / 更新单元格区域(values 为行优先二维数组)
  • 创建新表格或给现有表 新增标签页(tab)

错误体为 {"error":{"code","message","status"}},应原样展示。401 表示要重新安装或换 token;写操作若返回 403 PERMISSION_DENIED,多半是 token 只有 spreadsheets.readonly,需用含读写的 spreadsheets scope 重新授权。

边界与注意点

  • A1 记法: 如 Sheet1!A1:D20;标签名含空格时写成 'My Tab'!A1。
  • valueInputOption: RAW 按字符串原样写入;USER_ENTERED 与 UI 一致(数字、日期、=公式),选错会导致类型或公式行为不符预期。
  • 返回的 values 每行长度可能不齐,不要假设永远是矩形矩阵。

使用场景

  • CI 日志汇总任务要把构建号与状态追加到固定在线表的 `Sheet1!A:C`
  • 运维值班脚本读到告警行后,用 `values.update` 回写处理人与时间列
  • 数据同事用 API 新建空白表并 `addSheet`,再写入首行表头供协作编辑
  • 只读 token 拉取某范围的 `values`,用 jq 过滤后再决定是否请求写 scope

适合人员

  • 写 Shell 流水线、要把报表行写入共享 Google 表的后端工程师
  • 用 Agent 代查表内数据、再按条件改单元格的运维或 SRE
  • 不接官方 SDK、偏好 curl+jq 集成 Sheets v4 的自动化作者
  • 刚拿到只读 OAuth、需要判断何时升级为读写 scope 的集成维护者