Google 表格 curl 读写
将以下提示词粘贴到你的 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 的集成维护者