核心用法
ez-google 是一套面向代理/自动化场景的 Google Workspace CLI 工具集，采用托管 OAuth 方案，彻底消除传统 API 集成的配置负担。用户无需创建 Google Cloud 项目、无需申请 API Key、无需下载 credentials.json，仅需执行三步极简流程：检查认证状态 → 获取授权链接 → 粘贴返回的 Token 即可完成全套服务授权。
工具覆盖 Google 生态核心产品：Gmail（收发邮件、批量标签/删除）、Calendar（日程查询与创建）、Drive（文件管理与下载）、Docs/Sheets/Slides（文档读写与批量操作）、Contacts（联系人管理）以及 Workspace 专属的 Chat 服务。所有脚本统一使用 uv run 运行，参数设计遵循 CLI 直觉，支持批量操作（如一次性归档千封邮件）和结构化数据写入（表格行列用 ; 分隔）。
显著优点
1. 零摩擦接入：托管 OAuth 模式将 OAuth 2.0 的复杂性完全隐藏，对非技术用户和快速原型极友好
2. 全覆盖：单一工具包解决邮件、日程、文档、表格、幻灯片、云盘、联系人、即时通讯八大场景
3. 批量效率：Gmail 支持每 API 调用 1000 条的批量标签/删除操作，适合 inbox 清零自动化
4. Agent 原生设计：命令输出结构化、无交互式弹窗，完美适配 LLM Agent 和 CI/CD 流水线
潜在缺点与局限
- 托管服务依赖：OAuth 托管端若不可用，整个授权链路中断，存在单点故障风险
- 权限粒度粗：首次授权需授予全量 Workspace 权限，无法按需最小化授权（如仅用 Sheets 仍需同意 Gmail 访问）
- Workspace 功能限制：Google Chat 模块仅支持付费 Workspace 组织，个人 Gmail 账户无法使用
- Token 生命周期：未明确说明 refresh token 持久化策略，长期无人值守任务可能面临过期重授权
适合人群
- 需快速搭建 Google 自动化工作流的开发者与运维工程师
- 使用 Claude Code、Cursor 等 Agent IDE 的 AI 辅助编程用户
- 不愿投入时间配置 Google Cloud Console 的轻量用户
- 需要批量处理 Gmail 或定期同步 Sheets 数据的小型团队
常规风险
1. Token 泄露：粘贴的 OAuth Token 若被日志记录或历史命令留存，可导致 Google 账户完全接管
2. 批量操作不可逆：bulk-trash 与 bulk-label 无事务机制，误操作可能导致重要邮件永久丢失
3. 托管方信任：授权 Token 流经第三方托管服务，需确认运营方资质与数据处理方式
4. 权限扩散：Token 存储于本地环境，若设备共享或镜像泄露，关联的 Google 数据面临暴露风险