Gmail
发送、读取、搜索和移动 Gmail 邮件，或通过 Gmail 事件触发工作流
Gmail 是 Google 的一项流行电子邮件服务，提供了一个强大的平台，用于发送、接收和管理电子邮件通信。Gmail 拥有超过 18 亿的全球活跃用户，提供了功能丰富的体验，包括强大的搜索功能、组织工具和集成选项。
使用 Gmail，您可以：
- 发送和接收电子邮件：通过简洁直观的界面与联系人交流
- 组织邮件：使用标签、文件夹和过滤器保持收件箱井井有条
- 高效搜索：利用 Google 强大的搜索技术快速找到特定邮件
- 自动化工作流：创建过滤器和规则以自动处理收到的邮件
- 随时随地访问：通过设备同步的内容和设置使用 Gmail
- 与其他服务集成：连接 Google 日历、云端硬盘和其他生产力工具
在 Sim 中，Gmail 集成使您的代理能够以编程方式全面管理电子邮件，并具备全面的自动化功能。这支持强大的自动化场景，例如发送通知、处理收到的邮件、从电子邮件中提取信息以及大规模管理通信工作流。您的代理可以：
- 撰写和发送：创建带有附件的个性化电子邮件并发送给收件人
- 读取和搜索：使用 Gmail 的查询语法查找特定邮件并提取内容
- 智能组织：将邮件标记为已读/未读，存档或取消存档电子邮件，并管理标签
- 清理收件箱：删除邮件，在标签之间移动电子邮件，并保持收件箱整洁
- 触发工作流：实时监听新邮件，启用对收到邮件的响应式工作流
此集成弥合了您的 AI 工作流与电子邮件通信之间的差距，实现了与全球最广泛使用的通信平台之一的无缝交互。无论您是在自动化客户支持响应、处理收据、管理订阅，还是协调团队通信，Gmail 集成都提供了全面的电子邮件自动化所需的所有工具。
将 Gmail 集成到工作流中。可以发送、读取、搜索和移动电子邮件。可以在触发模式下使用，当收到新电子邮件时触发工作流。
使用 Gmail 发送电子邮件
| 参数 | 类型 | 必需 | 描述 |
|---|
to | 字符串 | 是 | 收件人邮箱地址 |
subject | 字符串 | 否 | 邮件主题 |
body | 字符串 | 是 | 邮件正文内容 |
contentType | 字符串 | 否 | 邮件正文的内容类型（文本或 HTML） |
threadId | 字符串 | 否 | 回复的线程 ID（用于线程化） |
replyToMessageId | 字符串 | 否 | Gmail 消息 ID，用于回复 - 使用 Gmail 读取结果中的 "id" 字段（不是 RFC 的 "messageId"） |
cc | 字符串 | 否 | 抄送收件人（逗号分隔） |
bcc | 字符串 | 否 | 密送收件人（逗号分隔） |
attachments | 文件[] | 否 | 附加到邮件的文件 |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
使用 Gmail 草拟电子邮件
| 参数 | 类型 | 必需 | 描述 |
|---|
to | 字符串 | 是 | 收件人邮箱地址 |
subject | 字符串 | 否 | 邮件主题 |
body | 字符串 | 是 | 邮件正文内容 |
contentType | 字符串 | 否 | 邮件正文的内容类型（文本或 HTML） |
threadId | 字符串 | 否 | 回复的线程 ID（用于线程化） |
replyToMessageId | 字符串 | 否 | Gmail 消息 ID，用于回复 - 使用 Gmail 读取结果中的 "id" 字段（不是 RFC 的 "messageId"） |
cc | 字符串 | 否 | 抄送收件人（逗号分隔） |
bcc | 字符串 | 否 | 密送收件人（逗号分隔） |
attachments | 文件[] | 否 | 附加到邮件草稿的文件 |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 草稿元数据 |
从 Gmail 读取电子邮件
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | string | 否 | 要读取的消息 ID |
folder | string | 否 | 要从中读取电子邮件的文件夹/标签 |
unreadOnly | boolean | 否 | 仅检索未读消息 |
maxResults | number | 否 | 要检索的最大消息数（默认：1，最大：10） |
includeAttachments | boolean | 否 | 下载并包含电子邮件附件 |
| 参数 | 类型 | 描述 |
|---|
content | 字符串 | 邮件的文本内容 |
metadata | JSON | 邮件的元数据 |
attachments | 文件[] | 邮件的附件 |
在 Gmail 中搜索邮件
| 参数 | 类型 | 必需 | 描述 |
|---|
query | 字符串 | 是 | 邮件搜索查询 |
maxResults | 数字 | 否 | 返回的最大结果数 |
| 参数 | 类型 | 描述 |
|---|
content | 字符串 | 搜索结果摘要 |
metadata | 对象 | 搜索元数据 |
在 Gmail 标签/文件夹之间移动邮件
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | 字符串 | 是 | 要移动的邮件 ID |
addLabelIds | 字符串 | 是 | 要添加的逗号分隔标签 ID (例如：INBOX, Label_123) |
removeLabelIds | 字符串 | 否 | 要移除的逗号分隔标签 ID (例如：INBOX, SPAM) |
| 参数 | 类型 | 描述 |
|---|
content | 字符串 | 成功消息 |
metadata | 对象 | 邮件元数据 |
将 Gmail 邮件标记为已读
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | 字符串 | 是 | 要标记为已读的邮件 ID |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
将 Gmail 邮件标记为未读
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | string | 是 | 要标记为未读的邮件 ID |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
归档 Gmail 邮件（从收件箱中移除）
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | string | 是 | 要归档的邮件 ID |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
取消归档 Gmail 邮件（移回收件箱）
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | string | 是 | 要取消归档的邮件 ID |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
删除 Gmail 邮件（移至垃圾箱）
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | string | 是 | 要删除邮件的 ID |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
为 Gmail 邮件添加标签
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | string | 是 | 要添加标签的邮件 ID |
labelIds | string | 是 | 要添加的逗号分隔标签 ID（例如：INBOX, Label_123） |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
从 Gmail 邮件中移除标签
| 参数 | 类型 | 必需 | 描述 |
|---|
messageId | string | 是 | 要移除标签的邮件 ID |
labelIds | string | 是 | 要移除的逗号分隔标签 ID（例如：INBOX, Label_123） |
| 参数 | 类型 | 描述 |
|---|
content | string | 成功消息 |
metadata | object | 邮件元数据 |
