Gmail 官方命令行，自动化邮件工作流

Gmail 官方 CLI 工具，支持邮件收发、草稿管理、标签分类及实时推送通知，适合开发者自动化邮件工作流。

基本信息

• 技能名称?Gws Gmail
• 中文名称?Gmail 官方命令行，自动化邮件工作流
• 作者?googleworkspace-bot
• 分类?专业技能
• 版本?1.0.14
• 标签?gmail, email, google-workspace, automation, cli, oauth, notification, productivity

使用方法

使用说明
核心用法
gws-gmail 是 Google Workspace CLI 工具集（GWS）中的 Gmail 模块，提供对 Gmail API 的完整命令行封装。基础调用格式为 gws gmail [flags] ，涵盖用户配置、草稿、标签、消息、会话线程等全量资源操作。
辅助快捷命令
+send ：快速发送邮件
+triage ：未读邮件摘要（发件人/主题/日期）
+reply / +reply-all ：自动处理会话线程的回复
+forward ：转发邮件
+read ：提取邮件正文或头信息
+watch ：NDJSON 格式实时流式监听新邮件
API 资源覆盖
users 资源下包含完整的子资源树：
getProfile / stop / watch ：用户配置与推送管理
drafts / history / labels / messages / settings / threads ：全功能邮件生命周期管理
显著优点

1. 官方生态整合 ：作为 GWS 工具链一环，与 Google Workspace 认证体系深度集成
2. 流式实时能力 ： +watch 支持 NDJSON 流式输出，适合构建事件驱动自动化
3. 会话感知 ：回复类命令自动处理 threadId ，避免手动维护会话上下文
4. Schema 自发现 ： gws schema 命令可动态查询 API 参数类型与必填项，降低文档依赖
   潜在局限
   前置依赖重 ：必须先行配置 gws-shared 的 OAuth 认证与全局安全策略
   CLI 学习曲线 ：资源-方法-标志的层级调用模式对非开发者不够直观
   版本锁定 ：v0.22.5 版本迭代较快，可能存在破坏性变更
   权限粒度粗 ：Gmail API 的 OAuth 范围较宽，敏感操作缺乏二次确认机制
   适合人群
   需要将邮件工作流集成到 CI/CD 或自动化脚本的开发者
   运维团队批量处理通知、告警邮件的场景
   构建 Gmail 机器人或自动归档系统的工程师
   常规风险
   令牌泄露 ：OAuth refresh token 本地存储，共享环境需额外隔离
   误发邮件 ：CLI 批量操作缺乏预览环节， +send 等命令执行即生效
   API 配额 ：Gmail API 存在每日调用上限，高频 +watch 可能触发限流
   数据残留 ： history 资源操作可能涉及敏感邮件元数据持久化
   gmail email google-workspace automation cli oauth notification productivity