用途：gog 是 Google Workspace 的命令行工具，覆盖 Gmail、Calendar、Drive、Contacts、Sheets、Docs，适合在终端或脚本中完成邮件收发、日程管理、文件搜索、联系人查看、表格读写与文档导出。
主要能力：Gmail 支持搜索、按邮件逐条搜索、发送、草稿创建与发送、回复；Calendar 支持列出、创建、更新事件及查看颜色；Drive 支持搜索；Contacts 支持列出；Sheets 支持读取、更新、追加、清空与查看元数据；Docs 支持导出、cat 与复制。
使用方式：首次需 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 查看。常用命令如 gog gmail search 'newer_than:7d' --max 10、gog gmail send --to a@b.com --subject "Hi" --body "Hello"、gog calendar events <calendarId> --from <iso> --to <iso>、gog drive search "query" --max 10、gog sheets get <sheetId> "Tab!A1:D10" --json、gog docs export <docId> --format txt --out /tmp/doc.txt。可用 GOG_ACCOUNT 环境变量避免重复传 --account；脚本场景建议配合 --json 与 --no-input。
限制与注意：邮件正文优先纯文本，多段内容用 --body-file（或 - 读 stdin），--body 不会转义 \n；仅在需要富文本时用 --body-html。Docs 仅支持导出、cat、复制，原地编辑需 Docs API 客户端，gog 不提供。发送邮件或创建事件前应先确认。gog gmail search 按会话返回一行，需要每封邮件单独返回时用 gog gmail messages search。其余未在资料中说明的功能、收费与平台支持暂未提供。