Gmail 节点消息操作#
使用消息操作（Message operations）在 Gmail 中发送、回复、删除邮件，标记为已读或未读，添加标签、移除标签，获取单个邮件或获取邮件列表。有关 Gmail 节点的更多信息，请参考 Gmail 节点文档。
为邮件添加标签#
使用此操作为邮件添加一个或多个标签。
输入以下参数：
- 选择用于连接的 Credential（凭据） 或创建一个新的凭据。
- Resource（资源）：选择 Message（消息）。
- Operation（操作）：选择 Add Label（添加标签）。
- Message ID（消息 ID）：输入要添加标签的邮件 ID。
- Label Names or IDs（标签名称或 ID）：选择要添加的标签名称，或输入表达式指定标签 ID。下拉列表的内容基于你选择的 Credential（凭据） 动态生成。
更多详情，请参考 Gmail API 方法：users.messages.modify 文档。
删除邮件#
使用此操作立即并永久删除一封邮件。
永久删除
此操作不可撤销。如需可恢复的删除，请改用 会话（Thread）移动到回收站操作。
输入以下参数：
- 选择用于连接的 Credential（凭据） 或创建一个新的凭据。
- Resource（资源）：选择 Message（消息）。
- Operation（操作）：选择 Delete（删除）。
- Message ID（消息 ID）：输入要删除的邮件 ID。
更多详情，请参考 Gmail API 方法：users.messages.delete 文档。
获取邮件#
使用此操作获取单封邮件。
输入以下参数：
- 选择用于连接的 Credential（凭据） 或创建一个新的凭据。
- Resource（资源）：选择 Message（消息）。
- Operation（操作）：选择 Get（获取）。
- Message ID（消息 ID）：输入要检索的邮件 ID。
- Simplify（简化输出）：选择是否返回简化的响应（开启）或原始数据（关闭）。默认为开启。
- 这等同于将 API 请求中的
format参数设置为metadata，此时仅返回邮件 ID、标签和邮件头信息，包括：From（发件人）、To（收件人）、CC（抄送）、BCC（密送）和 Subject（主题）。
- 这等同于将 API 请求中的
有关更多信息，请参考 Gmail API 方法：users.messages.get 文档。
获取多条消息#
使用此操作来获取两条或更多消息。 输入以下参数：
- 选择要连接的 Credential（凭据），或创建一个新的凭据。
- Resource（资源）：选择 Message（消息）。
- Operation（操作）：选择 Get Many（获取多个）。
- Return All（返回全部）：选择节点是否返回所有消息（开启）或仅返回设定数量限制内的消息（关闭）。
- Limit（限制）：输入最多返回的消息数量。仅在关闭 Return All 时生效。
- Simplify（简化）：选择是否返回响应的简化版本（开启）或原始数据（关闭）。默认为开启。
- 这相当于将 API 调用的
format设置为metadata，即只返回邮件 ID、标签和邮件头信息，包括：From（发件人）、To（收件人）、CC（抄送）、BCC（密送）和 Subject（主题）。
- 这相当于将 API 调用的
获取多条消息的过滤条件#
使用以下过滤器进一步细化节点的行为：
- Include Spam and Trash（包含垃圾邮件和已删除邮件）：选择节点是否获取垃圾邮件（Spam）和回收站（Trash）文件夹中的消息（开启）或不获取（关闭）。
- Label Names or IDs（标签名称或 ID）：仅返回带有指定标签的消息。可以选择标签名称，或输入表达式指定标签 ID。下拉列表内容基于所选的 Credential（凭据） 动态生成。
- Search（搜索）：输入 Gmail 搜索 refine 过滤条件（例如
from:），以进一步筛选返回的消息。更多信息请参考 在 Gmail 中优化搜索。 - Read Status（已读状态）：选择接收 未读和已读邮件、仅未读邮件（默认），或 仅已读邮件。
- Received After（接收时间之后）：仅返回在此指定日期和时间之后收到的邮件。可使用日期选择器选择具体时间，或输入表达式以 ISO 格式的字符串或毫秒级时间戳设置日期。有关字符串格式的更多信息，请参考 ISO 8601。
- Received Before（接收时间之前）：仅返回在此指定日期和时间之前收到的邮件。可使用日期选择器选择具体时间，或输入表达式以 ISO 格式的字符串或毫秒级时间戳设置日期。有关字符串格式的更多信息，请参考 ISO 8601。
- Sender（发件人）：输入邮箱地址或发件人姓名的一部分，以仅返回来自该发件人的消息。
请参考 Gmail API 方法：users.messages.list 文档以获取更多信息。
标记为已读#
使用此操作将邮件标记为已读。 输入以下参数：
- 选择要连接的凭据（Credential），或创建一个新的凭据。
- 资源（Resource）：选择 Message。
- 操作（Operation）：选择 Mark as Read。
- 消息 ID（Message ID）：输入你希望标记为已读的消息的 ID。
请参考 Gmail API 方法：users.messages.modify 文档以获取更多信息。
标记为未读#
使用此操作将邮件标记为未读。 输入以下参数：
- 选择要连接的凭据（Credential），或创建一个新的凭据。
- 资源（Resource）：选择 Message。
- 操作（Operation）：选择 Mark as Unread。
- 消息 ID（Message ID）：输入你希望标记为未读的消息的 ID。
请参考 Gmail API 方法：users.messages.modify 文档以获取更多信息。
从消息中移除标签#
使用此操作从一条消息中移除一个或多个标签。 输入以下参数：
- 选择要连接的凭据（Credential），或创建一个新的凭据。
- 资源（Resource）：选择 Message。
- 操作（Operation）：选择 Remove Label。
- 消息 ID（Message ID）：输入你要从中移除标签的消息 ID。
- 标签名称或 ID（Label Names or IDs）：选择要移除的标签名称，或输入表达式来指定标签 ID。下拉列表的内容会根据你选择的**凭据（Credential）**动态填充。
请参考 Gmail API 方法：users.messages.modify 文档以获取更多信息。
回复消息#
使用此操作作为对已有消息的回复发送新消息。 输入以下参数：
- 选择要连接的凭据（Credential），或创建一个新的凭据。
- 资源（Resource）：选择 Message。
- 操作（Operation）：选择 Reply。
- 消息 ID（Message ID）：输入你要回复的消息的 ID。
- 选择邮件类型（Email Type）：可选择 Text 或 HTML。
- 消息内容（Message）：输入邮件正文内容。
回复选项#
使用以下选项进一步调整节点的行为：
- 附加 n8n 归属信息（Append n8n attribution）：默认情况下，节点会在邮件末尾添加语句
This email was sent automatically with n8n。若要移除该语句，请关闭此选项。 - 附件（Attachments）：选择 Add Attachment 以添加附件。输入 输入中的附件字段名称（Attachment Field Name (in Input)），用于标识输入节点中包含附件的字段。
- 对于多个属性，请输入逗号分隔的列表。
- 密送（BCC）：输入一个或多个密送收件人的电子邮件地址。多个地址之间用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 抄送（CC）：输入一个或多个抄送收件人的电子邮件地址。多个地址之间用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 发件人姓名（Sender Name）：输入你希望在收件人邮箱中显示为发件人的名称。
- 仅回复发件人（Reply to Sender Only）：选择是否回复全部（关闭）或仅回复发件人（开启）。
更多信息请参考 Gmail API 方法：users.messages.send 文档。
发送消息#
使用此操作发送消息。 输入以下参数：
- 选择要连接的 Credential（凭据） 或创建一个新的凭据。
- 资源（Resource）：选择 Message（消息）。
- 操作（Operation）：选择 Send（发送）。
- 收件人（To）：输入你要发送邮件的目标邮箱地址。
- 主题（Subject）：输入邮件主题行。
- 选择 邮件类型（Email Type）：可选择 文本（Text） 或 HTML。
- 消息内容（Message）：输入邮件正文内容。
发送选项#
使用以下选项进一步调整节点的行为：
- 附加 n8n 标识（Append n8n attribution）：默认情况下，节点会在邮件末尾添加语句
This email was sent automatically with n8n。如需移除该语句，请关闭此选项。 - 附件（Attachments）：选择 Add Attachment 以添加附件。输入 输入中的附件字段名（Attachment Field Name (in Input)），用于指定输入节点中包含附件的字段。
- 对于多个属性，请输入逗号分隔的列表。
- 密送（BCC）：输入一个或多个密送收件人邮箱地址。多个邮箱地址之间用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 抄送（CC）：输入一个或多个抄送收件人邮箱地址。多个邮箱地址之间用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 发件人姓名（Sender Name）：输入你希望在收件人邮箱中显示为发件人的名称。
- 回复地址（Send Replies To）：输入一个邮箱地址，作为回复时的目标地址。
- 仅回复发件人（Reply to Sender Only）：选择是否回复全部（关闭）或仅回复发件人（开启）。
更多信息请参考 Gmail API 方法：users.messages.send 文档。
发送消息并等待审批#
使用此操作发送消息，并在继续工作流执行之前等待收件人的审批。
对于复杂审批场景，请使用 Wait 节点 发送并等待审批（Send and Wait for Approval） 操作适用于简单的审批流程。对于更复杂的审批需求，建议使用 Wait 节点。
输入以下参数：
- 选择要连接的 凭据（Credential） 或创建一个新的凭据。
- 资源（Resource）：选择 消息（Message）。
- 操作（Operation）：选择 发送并等待审批（Send and Wait for Approval）。
- 收件人（To）：输入你要发送邮件的目标邮箱地址。
- 主题（Subject）：输入邮件主题行。
- 消息内容（Message）：输入邮件正文内容。
发送并等待审批选项#
使用以下选项进一步细化节点的行为：
- 审批类型（Type of Approval）：选择 仅批准（Approve Only）（默认）仅包含一个批准按钮，或选择 批准和拒绝（Approve and Disapprove） 以同时包含拒绝选项。
- 批准按钮标签（Approve Button Label）：用于批准按钮的标签，默认为 批准（Approve）。
- 批准按钮样式（Approve Button Style）：将批准按钮设置为 主要（Primary）（默认）或 次要（Secondary） 样式。
- 拒绝按钮标签（Disapprove Button Label）：用于拒绝按钮的标签，默认为 拒绝（Decline）。仅当 审批类型（Type of Approval） 设置为 批准和拒绝（Approve and Disapprove） 时可见。
- 拒绝按钮样式（Disapprove Button Style）：将拒绝按钮设置为 主要（Primary） 或 次要（Secondary）（默认）样式。仅当 审批类型（Type of Approval） 设置为 批准和拒绝（Approve and Disapprove） 时可见。
更多信息请参考 Gmail API 方法：users.messages.send 文档。
常见问题#
有关常见错误、问题及建议的解决步骤，请参阅 常见问题（Common Issues）。