Skip to content

Gmail 节点消息操作#

使用消息操作来在 Gmail 中发送、回复、删除、标记为已读或未读、为消息添加标签、从消息移除标签，或获取消息或获取消息列表。请参考 Gmail 节点 了解有关 Gmail 节点本身的更多信息。

Add Label to a message 为消息添加标签#

使用此操作为消息添加一个或多个标签。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Add Label。
  • Message ID：输入您想要添加标签的消息的 ID。
  • Label Names or IDs：选择您想要添加的标签名称或输入表达式来指定 ID。下拉菜单根据您选择的 Credential 填充。

请参考 Gmail API 方法：users.messages.modify 文档了解更多信息。

Delete a message 删除消息#

使用此操作立即永久删除消息。

永久删除

此操作无法撤销。对于可恢复的删除，请改用 Thread Trash 操作。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Delete。
  • Message ID：输入您想要删除的消息的 ID。

请参考 Gmail API 方法：users.messages.delete 文档了解更多信息。

Get a message 获取消息#

使用此操作获取单个消息。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Get。
  • Message ID：输入您想要检索的消息的 ID。
  • Simplify：选择是否返回简化版本的响应（打开）还是原始数据（关闭）。默认为打开。
    • 这相当于将 API 调用的 format 设置为 metadata，它返回电子邮件消息 ID、标签和电子邮件标头，包括：From、To、CC、BCC 和 Subject。

请参考 Gmail API 方法：users.messages.get 文档了解更多信息。

Get Many messages 获取多个消息#

使用此操作获取两个或更多消息。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Get Many。
  • Return All：选择节点是否返回所有消息（打开）还是仅返回设定限制（关闭）。
  • Limit：输入要返回的最大消息数量。仅在您关闭 Return All 时使用。
  • Simplify：选择是否返回简化版本的响应（打开）还是原始数据（关闭）。默认为打开。
    • 这相当于将 API 调用的 format 设置为 metadata，它返回电子邮件消息 ID、标签和电子邮件标头，包括：From、To、CC、BCC 和 Subject。

Get Many messages filters 获取多个消息过滤器#

使用这些过滤器进一步完善节点的行为：

  • Include Spam and Trash：选择节点是否应该获取垃圾邮件和垃圾箱文件夹中的消息（打开）或不获取（关闭）。
  • Label Names or IDs：仅返回添加了所选标签的消息。选择您想要应用的标签名称或输入表达式来指定 ID。下拉菜单根据您选择的 Credential 填充。
  • Search：输入 Gmail 搜索精炼过滤器，如 from:，来过滤返回的消息。请参考 在 Gmail 中精炼搜索 了解更多信息。
  • Read Status：选择是否接收 Unread and read emails、Unread emails only（默认）或 Read emails only。
  • Received After：仅返回在指定日期和时间之后收到的电子邮件。使用日期选择器选择日期和时间，或输入表达式以 ISO 格式设置日期字符串或以毫秒为单位的时间戳。请参考 ISO 8601 了解更多关于字符串格式的信息。
  • Received Before：仅返回在指定日期和时间之前收到的电子邮件。使用日期选择器选择日期和时间，或输入表达式以 ISO 格式设置日期字符串或以毫秒为单位的时间戳。请参考 ISO 8601 了解更多关于字符串格式的信息。
  • Sender：输入电子邮件或发件人姓名的一部分，以仅返回来自该发件人的消息。

请参考 Gmail API 方法：users.messages.list 文档了解更多信息。

Mark as Read 标记为已读#

使用此操作将消息标记为已读。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Mark as Read。
  • Message ID：输入您想要标记为已读的消息的 ID。

请参考 Gmail API 方法：users.messages.modify 文档了解更多信息。

Mark as Unread 标记为未读#

使用此操作将消息标记为未读。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Mark as Unread。
  • Message ID：输入您想要标记为未读的消息的 ID。

请参考 Gmail API 方法：users.messages.modify 文档了解更多信息。

Remove Label from a message 从消息移除标签#

使用此操作从消息中移除一个或多个标签。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Remove Label。
  • Message ID：输入您想要移除标签的消息的 ID。
  • Label Names or IDs：选择您想要移除的标签名称或输入表达式来指定 ID。下拉菜单根据您选择的 Credential 填充。

请参考 Gmail API 方法：users.messages.modify 文档了解更多信息。

Reply to a message 回复消息#

使用此操作发送消息作为对现有消息的回复。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Reply。
  • Message ID：输入您想要回复的消息的 ID。
  • 选择 Email Type。从 Text 或 HTML 中选择。
  • Message：输入电子邮件正文。

回复选项#

使用这些选项进一步完善节点的行为：

  • Append n8n attribution：默认情况下，节点会在电子邮件末尾附加声明 This email was sent automatically with n8n。要移除此声明，请关闭此选项。
  • Attachments：选择 Add Attachment 来添加附件。输入 Attachment Field Name (in Input) 来识别输入节点中包含附件的字段。
    • 对于多个属性，输入逗号分隔的列表。
  • BCC：输入一个或多个密送收件人的电子邮件地址。用逗号分隔多个电子邮件地址，例如 [email protected], [email protected]。
  • CC：输入一个或多个抄送收件人的电子邮件地址。用逗号分隔多个电子邮件地址，例如 [email protected], [email protected]。
  • Sender Name：输入您希望在收件人电子邮件中显示为发件人的姓名。
  • Reply to Sender Only：选择是否回复全部（关闭）还是仅回复发件人（打开）。

请参考 Gmail API 方法：users.messages.send 文档了解更多信息。

Send a message 发送消息#

使用此操作发送消息。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • Resource：选择 Message。
  • Operation：选择 Send。
  • To：输入您想要发送电子邮件的电子邮件地址。
  • Subject：输入主题行。
  • 选择 Email Type。从 Text 或 HTML 中选择。
  • Message：输入电子邮件正文。

发送选项#

使用这些选项进一步完善节点的行为：

  • Append n8n attribution：默认情况下，节点会在电子邮件末尾附加声明 This email was sent automatically with n8n。要移除此声明，请关闭此选项。
  • Attachments：选择 Add Attachment 来添加附件。输入 Attachment Field Name (in Input) 来识别输入节点中包含附件的字段。
    • 对于多个属性，输入逗号分隔的列表。
  • BCC：输入一个或多个密送收件人的电子邮件地址。用逗号分隔多个电子邮件地址，例如 [email protected], [email protected]。
  • CC：输入一个或多个抄送收件人的电子邮件地址。用逗号分隔多个电子邮件地址，例如 [email protected], [email protected]。
  • Sender Name：输入您希望在收件人电子邮件中显示为发件人的姓名。
  • Send Replies To：输入要设置为回复地址的电子邮件地址。
  • Reply to Sender Only：选择是否回复全部（关闭）还是仅回复发件人（打开）。

请参考 Gmail API 方法：users.messages.send 文档了解更多信息。

Send a message and wait for approval 发送消息并等待审批#

使用此操作发送消息并等待收件人的审批后再继续工作流执行。

使用 Wait 进行复杂审批

Send and Wait for Approval 操作适用于简单的审批流程。对于更复杂的审批，请考虑使用 Wait 节点。

输入这些参数：

  • 选择要连接的凭据或创建新凭据。
  • 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 文档了解更多信息。

常见问题#

有关常见错误或问题及建议的解决步骤，请参考 常见问题。