# Gog Zh

> Google Workspace 命令行工具，用于 Gmail、日历、云盘、联系人、表格和文档。

- Skill: `l-lesteryu/gog-zh` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add l-lesteryu/gog-zh`
- Raw SKILL.md: https://api.skillmd.com/api/skills/l-lesteryu/gog-zh/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: l-lesteryu (https://skillmd.com/u/l-lesteryu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/l-lesteryu/gog-zh

---


# gog

使用 `gog` 管理 Gmail/日历/云盘/联系人/表格/文档。需要 OAuth 设置。

设置（一次性）
- `gog auth credentials /path/to/client_secret.json`
- `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs`
- `gog auth list`

常用命令
- Gmail 搜索: `gog gmail search 'newer_than:7d' --max 10`
- Gmail 发送: `gog gmail send --to a@b.com --subject "主题" --body "正文"`
- 日历: `gog calendar events <calendarId> --from <iso> --to <iso>`
- 云盘搜索: `gog drive search "查询内容" --max 10`
- 联系人: `gog contacts list --max 20`
- 表格读取: `gog sheets get <sheetId> "工作表!A1:D10" --json`
- 表格更新: `gog sheets update <sheetId> "工作表!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED`
- 表格追加: `gog sheets append <sheetId> "工作表!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS`
- 表格清除: `gog sheets clear <sheetId> "工作表!A2:Z"`
- 表格元数据: `gog sheets metadata <sheetId> --json`
- 文档导出: `gog docs export <docId> --format txt --out /tmp/doc.txt`
- 文档查看: `gog docs cat <docId>`

注意事项
- 设置 `GOG_ACCOUNT=you@gmail.com` 环境变量以避免重复使用 `--account` 参数。
- 编写脚本时，建议使用 `--json` 参数和 `--no-input` 参数。
- 表格数据可以通过 `--values-json` 参数传递（推荐）或作为行内数据。
- 文档支持导出/查看/复制。原地编辑需要 Docs API 客户端（gog 中不包含）。
- 发送邮件或创建事件前请确认。