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 邮件读写功能的开发者或运维人员。
限制与注意事项:
- 发送邮件前应始终确认收件人和邮件内容。
- 令牌刷新由外部机制处理,本技能不负责令牌的自动更新。
- 具体功能范围受限于所提供访问令牌的权限。