用途：gog 是 Google Workspace 的命令行工具，覆盖 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 send --to a@b.com --subject "Hi" --body "Hello"；多行正文用 --body-file，stdin 用 --body-file -，富文本用 --body-html。Calendar 支持查看/创建/更新事件与查看颜色，如 gog calendar events <calendarId> --from <iso> --to <iso>、gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7。Drive 支持 gog drive search "query"；Contacts 支持 gog contacts list --max 20。Sheets 支持 get、update、append、clear、metadata。Docs 支持 export、cat、copy。
限制与注意：邮件正文优先纯文本，--body 不解析 \n，正文换行需用 heredoc 或 $'Line 1\n\nLine 2'。可设置 GOG_ACCOUNT=you@gmail.com 免去重复 --account；脚本场景建议 --json 与 --no-input。gog docs 不支持原地编辑，需使用 Docs API 客户端。发送邮件或创建事件前应先确认。gog gmail search 按会话返回一行，需要逐封邮件时用 gog gmail messages search。