核心功能
ez-google 是一套面向 Agent/CLI 的 Google Workspace 集成工具集，采用托管 OAuth 方案，用户无需申请或配置任何 API 密钥，仅需点击授权链接、粘贴返回令牌即可完成认证。支持 Gmail、Calendar、Drive、Docs、Sheets、Slides、Contacts 及 Chat 八大核心服务，覆盖邮件收发、日程管理、文件操作、文档协作、联系人查询等常见办公场景。
显著优势
- 零配置上手：内置托管 OAuth 服务，彻底消除 API 密钥申请、OAuth 客户端配置等繁琐步骤
- 全栈覆盖：从邮件沟通到文档协作，单一工具满足 Google Workspace 完整工作流
- Agent 原生设计：命令行接口简洁统一，适合自动化脚本和 AI Agent 集成调用
- 权限按需扩展：新增服务后登出重登即可动态授权，无需重新部署
局限性与风险
- 托管 OAuth 依赖性：认证服务由第三方托管，若服务中断将完全无法使用；令牌安全性取决于托管方
- 令牌生命周期管理：用户需手动保存令牌，长期运行场景下可能面临过期刷新问题
- Workspace 功能受限：Chat 模块仅支持 Google Workspace 付费用户，个人 Gmail 账户无法使用
- 操作粒度较粗：文档/表格操作以整块文本为主，缺乏精细格式控制（如字体、颜色、公式等）
适用人群
- 需快速集成 Google Workspace 的自动化开发者/Agent 构建者
- 无 DevOps 资源、希望跳过 OAuth 配置流程的小型团队
- 临时性办公自动化需求（如定期报表生成、邮件批量处理）
安全建议
- 令牌应存储于环境变量或加密密钥管理服务，避免硬编码
- 生产环境建议定期轮换令牌并监控托管 OAuth 服务可用性
- 涉及敏感数据的表格/文档操作，建议额外审计日志记录