SuperAPI AI 工具集

google-gmail

办公与效率

查看项目

更新于 10-16 06:57

技能介绍

Google Gmail 是一个用于通过 Gmail API 读取和发送电子邮件的技能,基于 curl 命令和 OAuth2 访问令牌实现。

用途:该技能面向需要在命令行或自动化流程中操作 Gmail 的场景,提供对 Gmail 邮箱的基本读写能力。

主要能力:

  • 列出最近的邮件消息:通过调用 Gmail API 的 messages 端点并设置 maxResults 参数获取消息 ID 列表。
  • 读取指定邮件:使用 format=full 参数获取邮件的完整信息,并可提取主题、发件人和摘要等字段。
  • 发送邮件:将原始邮件内容(包含 From、To、Subject 和正文)进行 base64url 编码后,通过 POST 请求发送。
  • 搜索邮件:使用 q 参数按条件筛选邮件,例如按发件人或未读状态搜索。

使用方式: 该技能依赖环境变量 GOOGLE_ACCESS_TOKEN,该令牌需具备 gmail 权限范围。所有操作均通过 curl 命令向 Gmail API 端点发起 HTTP 请求,并可结合 jq 工具解析返回的 JSON 结果。发送邮件时,需先用 Python 脚本将原始邮件文本进行 base64url 编码,再以 JSON 格式提交。

适用场景: 适用于需要在脚本、命令行工具或自动化任务中集成 Gmail 邮件读写功能的开发者或运维人员。

限制与注意事项:

  • 发送邮件前应始终确认收件人和邮件内容。
  • 令牌刷新由外部机制处理,本技能不负责令牌的自动更新。
  • 具体功能范围受限于所提供访问令牌的权限。