gog 谷歌办公 CLI

要解决什么问题

在终端或自动化脚本里操作 Google 账号，常见做法是各自调用 REST API 或写多套 SDK：认证分散、命令风格不统一，Sheets 传参和 Docs 导出也要单独查文档。若你已经在用 Gmail 搜索语法、Calendar 时间范围、Drive 查询，更希望有一条 CLI 把 Gmail / Calendar / Drive / Contacts / Sheets / Docs 串在同一套 OAuth 与账号切换逻辑里。

技能如何工作

本技能围绕开源 CLI gog：先完成一次性 OAuth（credentials + 按邮箱绑定服务），之后用子命令直接干活。

• Gmail：gog gmail search 支持 Gmail 查询语法；gog gmail send 可发信（发信前务必确认收件人与正文）。
• Calendar：按 --from / --to 拉取事件列表。
• Drive / Contacts：搜索与列表，可配合 --max 限制条数。
• Sheets：get / update / append / clear / metadata；单元格数据推荐 --values-json，更新时可指定 USER_ENTERED 等输入模式。
• Docs：export（如 txt）与 cat；不支持通过 gog 做 Docs 正文就地编辑（需 Docs API 客户端）。

脚本场景建议固定账号：环境变量 GOG_ACCOUNT=you@gmail.com，并优先 --json 与 --no-input，避免交互打断流水线。

适用边界

• 依赖 Google OAuth 与本地 client_secret.json，多账号用 gog auth list 管理。
• 发邮件、创建日历事件等写操作，执行前人工确认，避免误操作。
• Sheets 行数据可用 JSON 或行内参数；复杂 Docs 编辑不在 gog 能力范围内。