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 'newer_than:7d' --max 10，按会话返回一行；需要逐封返回时用 gog gmail messages search）、发送纯文本/多行/stdin/HTML 邮件、创建草稿、发送草稿和回复。Calendar：列出、创建、更新事件，并可用 --event-color 指定颜色，gog calendar colors 查看可选颜色。Drive 支持搜索；Contacts 支持列表；Sheets 支持读取、更新、追加、清空和查看元数据；Docs 支持 export、cat 和 copy。
用法上，可用 GOG_ACCOUNT=you@gmail.com 避免重复传 --account；脚本场景建议使用 --json 与 --no-input。邮件正文优先纯文本，多段内容用 --body-file，也支持从 stdin 读取（--body-file -）；--body 不会转义 \n，需要内联换行可用 heredoc 或 $'Line 1\n\nLine 2'。仅需富文本时才用 --body-html。Sheets 的取值建议通过 --values-json 传入。
限制方面，Docs 仅支持导出、查看和复制，原地编辑需要 Docs API 客户端，gog 本身不提供。发送邮件或创建事件前应确认。其他未在资料中说明的功能、收费或平台信息暂未提供。