Gmail 节点邮件操作(Gmail node Message Operations)#
使用消息操作来发送、回复、删除、标记为已读或未读、添加标签、移除标签，或获取 Gmail 中的消息或消息列表。有关 Gmail 节点本身的更多信息，请参阅 Gmail 节点。
🌐 Use the Message operations to send, reply to, delete, mark read or unread, add a label to, remove a label from, or get a message or get a list of messages in Gmail. Refer to the Gmail node for more information on the Gmail node itself.
Human-in-the-loop for AI tool calls
This node can be used as a human review step for AI Agent tool calls. When configured this way, the AI Agent will pause and request human approval through this service before executing tools that require oversight. Learn more in Human-in-the-loop for AI tool calls.
为消息添加标签(Add Label to a message)#
使用此操作向消息添加一个或多个标签。
🌐 Use this operation to add one or more labels to a message.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择 添加标签。
- 消息 ID：输入你想要添加标签的消息的 ID。
- 标签名称或ID：选择你想要添加的标签名称，或输入表达式以指定ID。下拉菜单会根据你选择的凭据进行填充。
Refer to the Gmail API Method: users.messages.modify documentation for more information.
删除消息(Delete a message)#
使用此操作立即永久删除消息。
🌐 Use this operation to immediately and permanently delete a message.
永久删除
此操作无法撤销。对于可恢复的删除，请使用线程回收操作代替。
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择删除。
- 消息 ID：输入你想要删除的消息的 ID。
有关更多信息，请参阅 Gmail API 方法：users.messages.delete 文档。
🌐 Refer to the Gmail API Method: users.messages.delete documentation for more information.
获取消息(Get a message)#
使用此操作获取单条消息。
🌐 Use this operation to get a single message.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择 获取。
- 消息 ID：输入你希望检索的消息的 ID。
- 简化：选择返回简化版本的响应（开启）还是原始数据（关闭）。默认开启。
- 这与将 API 调用的
format设置为metadata相同，它会返回电子邮件消息 ID、标签和电子邮件头，包括：发件人、收件人、抄送、密送和主题。
- 这与将 API 调用的
有关更多信息，请参考 Gmail API 方法：users.messages.get 文档。
🌐 Refer to the Gmail API Method: users.messages.get documentation for more information.
获取多个消息(Get Many messages)#
使用此操作获取两条或多条消息。
🌐 Use this operation to get two or more messages.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择 获取多个。
- 返回所有：选择节点是返回所有消息（开启）还是仅返回设定数量的消息（关闭）。
- 限制：输入要返回的最大消息数。仅在你关闭返回全部时使用。
- 简化：选择返回简化版本的响应（开启）还是原始数据（关闭）。默认开启。
- 这与将 API 调用的
format设置为metadata相同，它会返回电子邮件消息 ID、标签和电子邮件头，包括：发件人、收件人、抄送、密送和主题。
- 这与将 API 调用的
获取多个消息筛选条件(Get Many messages filters)#
使用这些过滤器进一步优化节点的行为：
🌐 Use these filters to further refine the node's behavior:
- 包含垃圾邮件和已删除邮件：选择节点是否应接收垃圾邮件和已删除邮件文件夹中的消息（开启表示接收，关闭表示不接收）。
- 标签名称或ID：仅返回添加了所选标签的消息。选择要应用的标签名称或输入表达式以指定ID。下拉菜单会根据你选择的凭证进行填充。
- 搜索：输入 Gmail 搜索优化过滤器，例如
from:，以筛选返回的邮件。更多信息请参阅 在 Gmail 中优化搜索。 - 阅读状态：选择接收 未读和已读邮件、仅未读邮件（默认）或 仅已读邮件。
- 接收时间在之后：仅返回在指定日期和时间之后收到的电子邮件。使用日期选择器选择日期和时间，或输入表达式以将日期设置为 ISO 格式的字符串或毫秒时间戳。有关字符串格式的更多信息，请参阅 ISO 8601。
- 在此之前收到：仅返回在指定日期和时间之前收到的电子邮件。使用日期选择器选择日期和时间，或输入表达式以字符串（ISO 格式）或毫秒时间戳的形式设置日期。有关字符串格式的更多信息，请参阅 ISO 8601。
- 发件人：输入电子邮件或发件人名称的部分内容，以仅返回来自该发件人的邮件。
有关更多信息，请参阅 Gmail API 方法：users.messages.list 文档。
🌐 Refer to the Gmail API Method: users.messages.list documentation for more information.
标记为已读(Mark as Read)#
使用此操作将消息标记为已读。
🌐 Use this operation to mark a message as read.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择标记为已读。
- 消息 ID：输入你希望标记为已读的消息的 ID。
Refer to the Gmail API Method: users.messages.modify documentation for more information.
标记为未读(Mark as Unread)#
使用此操作将消息标记为未读。
🌐 Use this operation to mark a message as unread.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择 标记为未读。
- 消息 ID：输入你希望标记为未读的消息的 ID。
Refer to the Gmail API Method: users.messages.modify documentation for more information.
移除消息标签(Remove Label from a message)#
使用此操作可从消息中移除一个或多个标签。
🌐 Use this operation to remove one or more labels from a message.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择 移除标签。
- 消息 ID：输入你想要移除标签的消息 ID。
- 标签名称或ID：选择你想要移除的标签名称，或输入表达式以指定ID。下拉菜单会根据你选择的凭证进行填充。
Refer to the Gmail API Method: users.messages.modify documentation for more information.
回复消息(Reply to a message)#
使用此操作回复现有消息。
🌐 Use this operation to send a message as a reply to an existing message.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择回复。
- 消息 ID：输入你要回复的消息的 ID。
- 选择 邮件类型。可选择 文本 或 HTML。
- 消息：请输入电子邮件正文。
回复选项(Reply options)#
使用这些选项来进一步细化节点的行为：
🌐 Use these options to further refine the node's behavior:
- 附加 n8n 署名：默认情况下，该节点会在邮件末尾添加
This email was sent automatically with n8n声明。要移除此声明，请关闭此选项。 - 附件：选择 添加附件 来添加附件。输入 附件字段名称（在输入中） 以识别输入节点中包含附件的字段。
- 对于多个属性，请输入以逗号分隔的列表。
- 密送：输入一个或多个盲抄收件人的电子邮件地址。多个电子邮件地址请用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 抄送：输入一个或多个抄送收件人的电子邮件地址。多个电子邮件地址请用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 发件人名称：输入你希望在收件人的电子邮件中显示为发件人的名称。
- 仅回复发件人：选择是回复所有人（已关闭）还是仅回复发件人（已开启）。
有关更多信息，请参考 Gmail API 方法：users.messages.send 文档。
🌐 Refer to the Gmail API Method: users.messages.send documentation for more information.
发送消息(Send a message)#
使用此操作发送消息。
🌐 Use this operation to send a message.
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择 发送。
- 收件人：输入你希望邮件发送到的电子邮箱地址。
- 主题：请输入主题行。
- 选择 邮件类型。可选择 文本 或 HTML。
- 消息：请输入电子邮件正文。
发送选项(Send options)#
使用这些选项来进一步细化节点的行为：
🌐 Use these options to further refine the node's behavior:
- 附加 n8n 署名：默认情况下，该节点会在邮件末尾添加
This email was sent automatically with n8n声明。要移除此声明，请关闭此选项。 - 附件：选择 添加附件 来添加附件。输入 附件字段名称（在输入中） 以识别输入节点中包含附件的字段。
- 对于多个属性，请输入以逗号分隔的列表。
- 密送：输入一个或多个盲抄收件人的电子邮件地址。多个电子邮件地址请用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 抄送：输入一个或多个抄送收件人的电子邮件地址。多个电子邮件地址请用逗号分隔，例如
jay@gatsby.com, jon@smith.com。 - 发件人名称：输入你希望在收件人的电子邮件中显示为发件人的名称。
- 回复至：输入一个电子邮件地址以设置作为回复地址。
- 仅回复发件人：选择是回复所有人（已关闭）还是仅回复发件人（已开启）。
有关更多信息，请参考 Gmail API 方法：users.messages.send 文档。
🌐 Refer to the Gmail API Method: users.messages.send documentation for more information.
发送消息并等待批准(Send a message and wait for approval)#
使用此操作发送消息，并在继续执行工作流之前等待收件人批准。
🌐 Use this operation to send a message and wait for approval from the recipient before continuing the workflow execution.
使用等待以处理复杂审批
发送并等待批准 操作非常适合简单的审批流程。对于更复杂的审批，请考虑使用 等待节点。
请输入以下参数：
🌐 Enter these parameters:
- 选择要使用的 凭据 进行连接，或创建一个新的。
- 资源：选择消息。
- 操作：选择 发送并等待批准。
- 收件人：输入你希望邮件发送到的电子邮箱地址。
- 主题：请输入主题行。
- 消息：请输入电子邮件正文。
发送并等待批准选项(Send and wait for approval options)#
使用这些选项来进一步细化节点的行为：
🌐 Use these options to further refine the node's behavior:
- 批准类型：选择 仅批准（默认）仅包括批准按钮，或选择 批准与拒绝 以同时包括拒绝选项。
- 批准按钮标签：用于批准按钮的标签（默认为 批准）。
- 批准按钮样式：是否将批准按钮设置为主要（默认）或次要按钮。
- 拒绝按钮标签：用于拒绝按钮的标签（默认值为拒绝）。仅在将审批类型设置为同意和拒绝时可见。
- 不赞成按钮样式：是否将不赞成按钮设置为主要或次要（默认）按钮。仅在你将审批类型设置为批准和不批准时可见。
有关更多信息，请参考 Gmail API 方法：users.messages.send 文档。
🌐 Refer to the Gmail API Method: users.messages.send documentation for more information.
常见问题(Common issues)#
有关常见错误或问题及建议的解决步骤，请参考 常见问题。
🌐 For common errors or issues and suggested resolution steps, refer to Common Issues.