核心用法
gog 是一款面向 Google Workspace 的命令行工具，支持通过终端直接操作 Gmail、日历、云端硬盘、联系人、Google 表格和文档六大核心服务。用户需先完成 OAuth2 认证流程，配置客户端凭证并授权特定 Google 账号访问指定服务范围。
主要功能模块
- Gmail: 搜索邮件（支持线程/单邮件模式）、读取正文、下载附件、发送纯文本/HTML 邮件、管理草稿、回复邮件
- 日历: 查询事件、创建/更新日程、自定义事件颜色（11 种预设色）
- 云端硬盘: 文件搜索与基本操作
- 联系人: 列表查询
- Google 表格: 读取单元格、更新数据、追加行、清除范围、获取元数据，支持 JSON 格式交互
- Google 文档: 导出为多种格式（TXT 等）、直接查看内容
显著优点
- 统一入口: 单一 CLI 覆盖 Workspace 六大服务，无需切换多个工具
- 脚本友好: 支持
--json输出、--no-input非交互模式，便于集成自动化工作流 - 灵活的邮件发送: 支持纯文本文件、stdin、HTML 多种输入方式，满足从简单通知到富文本邮件的需求
- 无头环境支持: 通过环境变量或文件密钥环支持服务器/容器部署
潜在缺点与局限性
- OAuth 配置门槛: 需自行在 Google Cloud Console 创建项目、启用 API、下载 client_secret.json，对非技术用户不够友好
- 文档编辑受限: Google 文档仅支持导出/查看，不支持直接编辑内容
- 权限范围较宽: 申请的服务权限（gmail.modify、calendar、drive 等）属于敏感范围，需用户充分信任
- 第三方维护: 由个人开发者（steipete）通过 Homebrew 分发，非 Google 官方工具
适合人群
- 开发者与 DevOps 工程师，需要自动化邮件发送、日历管理、数据报表更新
- 系统管理员，需批量处理 Workspace 数据或构建集成脚本
- 喜欢命令行效率的高级用户
常规风险
- 令牌安全: OAuth refresh token 存储于本地密钥环，共享设备需妥善保管
- 误操作风险: 邮件发送、日历创建等操作不可逆，建议生产环境配合
--no-input和二次确认机制 - API 配额限制: 高频调用可能触发 Google API 速率限制
- 依赖维护: 第三方工具的更新频率和长期维护存在不确定性