Gmail 节点消息操作#
使用消息操作可以在 Gmail 中发送、回复、删除、标记已读或未读、添加标签、移除标签、获取单个消息或获取消息列表。有关 Gmail 节点本身的更多信息，请参阅 Gmail 节点。
为消息添加标签#
使用此操作为消息添加一个或多个标签。
输入以下参数：
- 选择连接凭证或创建新凭证
- 资源：选择消息
- 操作：选择添加标签
- 消息 ID：输入要添加标签的消息 ID
- 标签名称或 ID：选择要添加的标签名称或输入表达式指定 ID。下拉选项会根据您选择的凭证自动填充
更多信息请参考 Gmail API 方法：users.messages.modify 文档。
删除消息#
使用此操作可立即永久删除消息。
永久删除
此操作无法撤销。如需可恢复的删除操作，请改用线程移至回收站操作。
输入以下参数：
- 选择连接凭证或创建新凭证
- 资源：选择消息
- 操作：选择删除
- 消息 ID：输入要删除的消息 ID
更多信息请参考 Gmail API 方法：users.messages.delete 文档。
获取单条消息#
使用此操作可获取单条消息。
输入以下参数：
- 选择连接凭据或创建新凭据
- 资源：选择消息
- 操作：选择获取
- 消息ID：输入您要检索的消息ID
- 简化响应：选择是否返回简化版本响应（开启）或原始数据（关闭）。默认为开启。
- 这等同于将API调用的
format参数设置为metadata，返回内容包括：邮件消息ID、标签和邮件头信息（发件人、收件人、抄送、密送和主题）。
- 这等同于将API调用的
更多信息请参考Gmail API方法：users.messages.get文档。
获取多条消息#
使用此操作可获取两条或更多消息。
输入以下参数：
- 选择连接凭据或创建新凭据
- 资源：选择消息
- 操作：选择获取多条
- 返回全部：选择节点是否返回所有消息（开启）或仅返回设定上限数量（关闭）
- 数量限制：输入要返回的最大消息数。仅在关闭返回全部时使用
- 简化响应：选择是否返回简化版本响应（开启）或原始数据（关闭）。默认为开启。
- 这等同于将API调用的
format参数设置为metadata，返回内容包括：邮件消息ID、标签和邮件头信息（发件人、收件人、抄送、密送和主题）。
- 这等同于将API调用的
获取多条消息的筛选条件#
使用以下筛选条件进一步调整节点的行为：
- 包含垃圾邮件和已删除邮件：选择节点是否应获取垃圾邮件和已删除邮件文件夹中的消息（开启）或不获取（关闭）。
- 标签名称或ID：仅返回添加了所选标签的消息。从下拉菜单中选择要应用的标签名称，或输入表达式指定ID。下拉菜单内容基于您选择的凭证自动填充。
- 搜索：输入Gmail搜索细化条件，如
from:，以筛选返回的消息。更多信息请参考在Gmail中细化搜索。 - 阅读状态：选择接收未读和已读邮件、仅未读邮件（默认）或仅已读邮件。
- 接收时间晚于：仅返回在指定日期和时间之后接收的邮件。使用日期选择器选择日期和时间，或输入表达式将日期设置为ISO格式的字符串或毫秒时间戳。有关字符串格式的更多信息，请参考ISO 8601。
- 接收时间早于：仅返回在指定日期和时间之前接收的邮件。使用日期选择器选择日期和时间，或输入表达式将日期设置为ISO格式的字符串或毫秒时间戳。有关字符串格式的更多信息，请参考ISO 8601。
- 发件人：输入电子邮件地址或发件人名称的一部分，以仅返回来自该发件人的消息。
更多信息请参考Gmail API方法：users.messages.list文档。
标记为已读#
使用此操作将消息标记为已读。
输入以下参数：
- 选择连接凭据或创建新凭据
- 资源：选择消息
- 操作：选择标记为已读
- 消息 ID：输入要标记为已读的消息 ID
更多信息请参考 Gmail API 方法：users.messages.modify 文档
标记为未读#
使用此操作将消息标记为未读。
输入以下参数：
- 选择连接凭据或创建新凭据
- 资源：选择消息
- 操作：选择标记为未读
- 消息 ID：输入要标记为未读的消息 ID
更多信息请参考 Gmail API 方法：users.messages.modify 文档
从消息中移除标签#
使用此操作从消息中移除一个或多个标签。
输入以下参数：
- 选择连接凭据或创建新凭据
- 资源：选择消息
- 操作：选择移除标签
- 消息 ID：输入要移除标签的消息 ID
- 标签名称或 ID：选择要移除的标签名称或输入表达式指定 ID。下拉选项会根据您选择的凭据自动填充
更多信息请参考 Gmail API 方法：users.messages.modify 文档
回复消息#
使用此操作可以发送消息作为对现有消息的回复。
输入以下参数：
- 选择连接凭据或创建新凭据
- 资源：选择消息
- 操作：选择回复
- 消息ID：输入您要回复的消息ID
- 选择邮件类型。可选纯文本或HTML
- 消息内容：输入邮件正文
回复选项#
使用这些选项进一步调整节点的行为：
- 添加n8n署名：默认情况下，节点会在邮件末尾添加声明
此邮件由n8n自动发送。要移除此声明，请关闭此选项 - 附件：选择添加附件来添加附件。输入附件字段名称(在输入中)以标识输入节点中包含附件的字段
- 对于多个属性，请输入逗号分隔的列表
- 密送(BCC)：输入一个或多个密送收件人的电子邮件地址。多个地址用逗号分隔，例如
jay@gatsby.com, jon@smith.com - 抄送(CC)：输入一个或多个抄送收件人的电子邮件地址。多个地址用逗号分隔，例如
jay@gatsby.com, jon@smith.com - 发件人名称：输入您希望在收件人邮件中显示的发件人名称
- 仅回复发件人：选择是回复所有人(关闭)还是仅回复发件人(开启)
更多信息请参考Gmail API方法：users.messages.send文档。
发送消息#
使用此操作来发送消息。
输入以下参数：
- 选择连接凭证或创建新凭证
- 资源：选择消息
- 操作：选择发送
- 收件人：输入要发送邮件的电子邮件地址
- 主题：输入邮件主题行
- 选择邮件类型。可选择纯文本或HTML
- 消息内容：输入邮件正文内容
发送选项#
使用以下选项进一步调整节点行为：
- 添加n8n署名：默认情况下，节点会在邮件末尾添加
此邮件由n8n自动发送的声明。如需移除该声明，请关闭此选项 - 附件：选择添加附件来添加附件。输入附件字段名称(在输入中)以标识输入节点中包含附件的字段
- 对于多个属性，请输入逗号分隔的列表
- 密送(BCC)：输入一个或多个密件抄送收件人的电子邮件地址。多个地址用逗号分隔，例如
jay@gatsby.com, jon@smith.com - 抄送(CC)：输入一个或多个抄送收件人的电子邮件地址。多个地址用逗号分隔，例如
jay@gatsby.com, jon@smith.com - 发件人名称：输入您希望在收件人邮件中显示的发件人名称
- 回复地址：输入要设置为回复地址的电子邮件地址
- 仅回复发件人：选择是回复所有人(关闭)还是仅回复发件人(开启)
更多信息请参考Gmail API方法：users.messages.send文档。
发送消息并等待审批#
使用此操作可以发送消息并等待收件人审批后再继续执行工作流。
复杂审批请使用 Wait 节点
发送并等待审批操作适用于简单的审批流程。对于更复杂的审批，请考虑使用 Wait 节点。
输入以下参数：
- 选择连接凭证或创建新凭证
- 资源：选择 Message
- 操作：选择 Send and Wait for Approval
- 收件人：输入要发送邮件的电子邮件地址
- 主题：输入邮件主题行
- 消息内容：输入邮件正文
发送并等待审批选项#
使用这些选项可以进一步调整节点的行为：
- 审批类型：选择 仅批准（默认）仅包含批准按钮，或选择 批准和拒绝 同时包含拒绝选项
- 批准按钮标签：批准按钮的显示文本（默认为 Approve）
- 批准按钮样式：将批准按钮样式设置为 Primary（默认）或 Secondary
- 拒绝按钮标签：拒绝按钮的显示文本（默认为 Decline）。仅在审批类型设置为批准和拒绝时可见
- 拒绝按钮样式：将拒绝按钮样式设置为 Primary 或 Secondary（默认）。仅在审批类型设置为批准和拒绝时可见
更多信息请参考 Gmail API 方法：users.messages.send 文档。
常见问题#
有关常见错误或问题及建议的解决步骤，请参阅常见问题。