gog 是一个 Google Workspace 命令行工具（CLI），通过终端命令访问 Gmail、Calendar、Drive、Contacts、Sheets 和 Docs。使用前需一次性配置 OAuth：运行 gog auth credentials /path/to/client_secret.json 导入凭据，再用 gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets 添加账号和服务，gog auth list 可查看已授权账号。
主要能力涵盖：Gmail 的搜索、发送、草稿、回复（如 gog gmail search、gog gmail send、gog gmail drafts create/send）；Calendar 的事件查询、创建、更新和颜色设置（gog calendar events/create/update/colors）；Drive 搜索（gog drive search）；Contacts 列表（gog contacts list）；Sheets 的读取、更新、追加、清空和元数据（gog sheets get/update/append/clear/metadata）；Docs 的导出与读取（gog docs export、gog docs cat）。
使用要点：设置 GOG_ACCOUNT=you@gmail.com 可免去重复输入 --account；脚本场景建议使用 --json 和 --no-input；Sheets 数据推荐通过 --values-json 传入；邮件正文优先使用纯文本，多段落可用 --body-file（或 --body-file - 从 stdin 读取），需要富格式时用 --body-html，--body 不会转义 \n。日历事件颜色可用 --event-color 指定（ID 1-11，通过 gog calendar colors 查看）。
限制：Docs 仅支持 export/cat/copy，就地编辑需要 Docs API 客户端，gog 不提供；gog gmail search 每条线程返回一行，如需逐封邮件应使用 gog gmail messages search。发送邮件或创建事件前应先行确认。