SuperAPI AI 工具集

gmail

办公与效率

查看项目

更新于 10-16 07:25

技能介绍

用途:该技能基于 Gmail API 提供邮件管理能力,当用户提到“check email”“send email”“search Gmail”“my inbox”或 Gmail 消息时使用。

主要能力:获取用户资料;列出与搜索消息(支持 is:unread、from:、subject:、after:、has:attachment、label:INBOX 等查询语法);获取消息(可仅取元数据);发送邮件与回复会话;修改消息标签、移入回收站或永久删除;管理会话(列出、获取、移入回收站);管理标签(列出、创建、删除);管理草稿(列出、创建、发送、删除,支持附件);获取附件;读取与更新假期自动回复设置;列出与创建过滤器。

使用方式:所有请求需携带 Authorization: Bearer $GMAIL_TOKEN。示例:curl -s "https://gmail.googleapis.com/gmail/v1/users/me/profile" --header "Authorization: Bearer $GMAIL_TOKEN"。发送邮件需构造 RFC 2822 消息并做 base64url 编码,非 ASCII 主题用 RFC 2047 编码,再 POST 到 messages/send。回复会话需带 In-Reply-To 与 References 头及 threadId。带附件草稿可用 Python 标准 email 库生成 RFC822 消息,上传到 upload/gmail/v1/users/me/drafts?uploadType=media。正文为 base64url 编码,可用 tr '_-' '/+' | base64 -d 解码。

适用场景:收件箱检查、邮件搜索、发送与回复、标签整理、草稿与附件处理、假期回复与过滤器配置。

限制:Gmail API 有配额限制,需实现指数退避;消息须符合 RFC 2822 并 base64url 编码;不同操作需要相应 OAuth 范围(如 gmail.readonly、gmail.send、gmail.compose、gmail.modify、gmail.labels、gmail.settings.basic、gmail.settings.sharing)。故障排查可运行 zero doctor check-connector --env-name GMAIL_TOKEN 或 zero doctor check-connector --url https://gmail.googleapis.com/gmail/v1/users/me/profile --method GET。