核心用法
Gmail技能是Maton平台提供的托管式Gmail API网关，开发者通过单一Maton API Key即可调用完整的Gmail REST API功能，无需自行处理Google OAuth 2.0的复杂授权流程。
典型调用模式：
1. 获取Maton API Key并设置环境变量
2. 在ctrl.maton.ai创建Google OAuth连接，完成浏览器授权
3. 通过gateway.maton.ai/google-mail代理端点调用任意Gmail API
支持的核心操作包括：消息列表查询（支持Gmail搜索语法如is:unread、from:、after:）、单条消息获取、邮件发送（需base64编码）、标签管理、会话线程操作、草稿创建与发送、以及垃圾桶管理。
显著优点
| 优势 | 说明 |
|------|------|
| **零OAuth运维成本** | Maton托管令牌刷新、权限续约，开发者无需维护refresh_token逻辑 |
| **原生API完整透传** | 直接代理Google官方API，功能100%对齐，无能力裁剪 |
| **多账户支持** | 通过`Maton-Connection`头可在同一API Key下切换多个Gmail账户 |
| **熟悉的技术栈** | 标准HTTP/REST接口，支持任意语言（文档提供Python、JavaScript、Bash示例） |
| **细粒度权限控制** | OAuth授权时用户可精确选择授权范围，符合Google安全模型 |
潜在缺点与局限性
- 供应商锁定风险：邮件数据流经Maton网关（gateway.maton.ai），存在单点故障和服务连续性依赖
- 速率限制：明确标注10 req/sec每账户，高并发场景需自行实现队列或降级策略
- 编码复杂度：发送邮件需手动处理base64url编码，无高层封装SDK降低开发效率
- 环境变量陷阱：文档特别提示
curl管道到jq时环境变量可能无法展开，存在调试摩擦成本 - 网络依赖：所有调用必须连通Maton服务，无法离线或私有部署
适合人群
- 快速原型开发者：需在数小时内集成邮件功能，不愿投入OAuth基础设施
- 多账户管理场景：如SaaS工具需代管客户Gmail，通过connection_id隔离
- 自动化工作流构建者：结合LLM或定时任务实现邮件分类、自动回复、数据提取
常规风险
| 风险类型 | 评估 |
|---------|------|
| 凭证泄露 | Maton API Key为Bearer令牌，若泄露则攻击者可访问关联的所有Gmail账户；需严格遵循密钥管理最佳实践 |
| 权限过度申请 | 用户授权时若选择过度范围（如全账户访问），可能导致敏感邮件暴露；建议引导用户选择最小权限 |
| 中间人攻击 | 流量经Maton网关，虽使用TLS，但需信任Maton的数据处理合规性；无端到端加密选项 |
| 数据滞留 | 邮件内容在传输过程中经过Maton服务器，敏感场景需评估数据主权和隐私合规要求 |