ez-google 是一套专为开发者设计的轻量级命令行工具集，用于高效集成和管理 Google Workspace 生态中的核心服务。它通过简化的认证流程和直观的 CLI 接口，让用户能够无需配置复杂的 API 密钥或本地凭证，即可实现对 Gmail、Google 日历、云端硬盘（Drive）、文档（Docs）、表格（Sheets）、幻灯片（Slides）以及联系人（People）等服务的自动化操作。该工具采用托管式 OAuth 认证机制，用户只需运行一次 `auth.py login` 命令，点击生成的链接完成授权，然后将返回的 token 粘贴保存即可完成身份验证，极大降低了使用门槛。整个系统对代理环境友好，支持在受限网络环境下稳定运行，非常适合需要批量处理邮件、管理日程、同步文件或生成办公文档等场景。所有功能均以 Python 脚本形式提供，可通过统一的 `uv run scripts/.py` 命令调用，具备良好的可扩展性和脚本化能力。
核心功能特点
- 基于托管 OAuth 的无密钥认证流程，用户仅需点击链接并复制令牌即可完成授权
- 支持 Gmail 邮件收发、搜索、标签管理及批量删除等批量操作
- 可读写 Google 日历事件，包括创建、查询、删除及多日历管理
- 提供云端文件全生命周期管理：上传、下载、搜索、创建文件夹及元数据读取
- 支持 Google Docs、Sheets、Slides 的内容创建、编辑与结构化数据处理
- 集成联系人查询与管理功能，支持按姓名检索和详细信息获取
适用场景
ez-google 特别适合需要自动化处理日常办公任务的团队或个人开发者。例如，市场运营人员可以编写脚本自动发送营销邮件、归档促销信息，并通过批量标签功能对收件箱进行智能分类；项目经理则可利用其快速创建会议日程、同步团队成员日历，并自动导出项目进度文档到云端；数据分析师可以通过脚本从 Google Sheets 中定期抓取报表数据，结合其他工具实现自动化报告生成。对于 IT 运维人员而言，该工具可用于监控企业邮箱状态、清理过期文件或备份重要文档，提升工作效率的同时减少人工干预。此外，由于 ez-google 完全基于命令行操作且无需持久化存储敏感凭证，它也非常适合集成进 CI/CD 流水线或定时任务系统中，实现无人值守的后台办公自动化。无论是小型创业公司还是大型企业，只要依赖 Google Workspace 作为主要协作平台，都能从中受益。