Gmail

Gmail 是什么

Gmail Skill 通过 Maton 网关代理 Gmail 原生 API，使用托管 OAuth 读取消息和线程，并管理标签、草稿、发送与回收站。

适用场景

适合受控 Gmail 自动化；其他邮箱或无需中间服务的场景应使用对应官方集成。

核心能力与工作机制

支持搜索、分页、读取元数据或正文、发送回复转发、修改标签、创建与发送草稿，并管理多个连接。

执行流程

安装 Maton CLI，设置 API Key 并建立 Google OAuth 连接；先指定连接和只读测试，所有写操作前确认对象与影响。

输入与输出

需要 MATON_API_KEY、有效 Gmail 连接和查询；发送需收件人、主题、正文和附件。输出 Gmail API JSON；写操作会改变真实邮箱或向外部收件人发送邮件。

依赖、账号与权限

需要网络、Maton 账号与 API Key、Google OAuth 授权，可使用 CLI、Python 或 JavaScript。

副作用、限制与风险

邮件含敏感信息和提示注入，第三方网关会处理 API 请求；密钥和 OAuth 连接泄露影响邮箱。会读取、发送、修改标签、创建草稿或移入回收站；删除连接会撤销集成。

不适用边界

不得访问未授权邮箱、未经确认发送或删除，也不能假设托管 OAuth 等于零数据外送。

失败处理与验收

400 检查连接，401 检查 Key，多连接时显式指定；发送状态未知先查 Sent 和 Message-ID。确认连接账号、查询范围、收件人、线程和标签变化，写操作后重新读取 Gmail 状态。

适合谁使用

适合需要 Gmail API 的自动化人员，高敏邮箱应评估直连和第三方处理边界。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.8 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Gmail 主要解决什么问题？

Gmail Skill 通过 Maton 网关代理 Gmail 原生 API，使用托管 OAuth 读取消息和线程，并管理标签、草稿、发送与回收站。适合受控 Gmail 自动化；其他邮箱或无需中间服务的场景应使用对应官方集成。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要 MATON_API_KEY、有效 Gmail 连接和查询；发送需收件人、主题、正文和附件。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

安装 Maton CLI，设置 API Key 并建立 Google OAuth 连接；先指定连接和只读测试，所有写操作前确认对象与影响。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

需要网络、Maton 账号与 API Key、Google OAuth 授权，可使用 CLI、Python 或 JavaScript。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会读取、发送、修改标签、创建草稿或移入回收站；删除连接会撤销集成。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不得访问未授权邮箱、未经确认发送或删除，也不能假设托管 OAuth 等于零数据外送。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

400 检查连接，401 检查 Key，多连接时显式指定；发送状态未知先查 Sent 和 Message-ID。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

确认连接账号、查询范围、收件人、线程和标签变化，写操作后重新读取 Gmail 状态。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。