gog 谷歌办公命令行
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-gog。
技能介绍
问题从哪来
Google Workspace 的邮件、日历、表格和文档分散在网页与各自 API 里。若你只想在 shell 里查一封近期邮件、拉一段 Sheet 范围或把 Doc 导出成纯文本,单独写 OAuth 客户端和 REST 调用往往比任务本身更费时间。gog 把同一套 Google 账号授权收敛成 CLI,面向脚本与日常运维式操作。
它实际上能做什么
一次性 OAuth:用 client_secret.json 执行 gog auth credentials,再 gog auth add 绑定账号并勾选 gmail,calendar,drive,contacts,sheets,docs 等服务,gog auth list 核对已授权账户。
各服务命令(与 SKILL.md 一致):
- Gmail:
gog gmail search(如newer_than:7d)与gog gmail send(--to、--subject、--body)。 - Calendar:
gog calendar events配合--from/--to查询事件。 - Drive:
gog drive search带查询串与--max。 - Contacts:
gog contacts list。 - Sheets:
gog sheets get读区域(如Tab!A1:D10,可加--json);update/append/clear通过--values-json与USER_ENTERED、INSERT_ROWS等选项写数据;metadata看表结构。 - Docs:
gog docs export(如--format txt)与gog docs cat读内容。
脚本场景可设 GOG_ACCOUNT 免重复 --account,并优先 --json 与 --no-input。
边界与注意点
发邮件、创建日历事件前应人工确认,避免误操作。Docs 就地编辑不在 gog 内,需另用 Docs API 客户端。Sheets 数值可用 --values-json 或行内行传递,导出与只读类任务最适合本工具。
使用场景
- 用 Gmail 搜索语法筛出最近 7 天邮件并限制条数,核对告警或工单通知
- 按时间窗拉取 Google 日历事件列表,写入本地日志或与值班表对照
- 用 `gog sheets get` 读取指定 Tab 区域并 `--json` 输出,供下游脚本解析
- 将 Google Doc 以 txt 导出到本地路径,做 diff 或全文检索
适合人员
- 需要在终端发搜索或发信、又不想维护独立 Gmail API 脚本的 SRE
- 每周从固定 Google Sheet 区域拉 JSON 做报表或 ETL 的数据/运营同学
- 用日历事件窗做值班巡检、希望命令行可查可记录的团队负责人
- 管理多 Google 账号并靠 GOG_ACCOUNT 切换、批量跑只读 Drive/Contacts 查询的自动化维护者