Gmail 节点主题操作#

使用主题操作（Thread operations）来删除、回复、移动到垃圾箱、从垃圾箱恢复、添加/移除标签、获取单个主题或列出多个主题。有关 Gmail 节点的更多信息，请参阅 Gmail 节点文档。

为主题添加标签#

使用此操作为现有主题添加标签。

输入以下参数：

• 选择用于连接的 Credential（凭据），或创建一个新的凭据。
• Resource（资源）：选择 Thread（主题）。
• Operation（操作）：选择 Add Label（添加标签）。
• Thread ID（主题 ID）：输入要添加标签的主题的 ID。
• Label Names or IDs（标签名称或 ID）：选择要应用的标签名称，或输入表达式指定标签 ID。下拉列表的内容基于你选择的 Credential（凭据） 动态生成。

更多详情，请参考 Gmail API 方法：users.threads.modify 文档。

删除主题#

使用此操作立即并永久删除一个主题及其所有邮件。

永久删除

此操作无法撤销。如需可恢复的删除，请改用 移动到垃圾箱操作。

输入以下参数：

• 选择用于连接的 Credential（凭据），或创建一个新的凭据。
• Resource（资源）：选择 Thread（主题）。
• Operation（操作）：选择 Delete（删除）。
• Thread ID（主题 ID）：输入要删除的主题的 ID。

更多详情，请参考 Gmail API 方法：users.threads.delete 文档。

获取一个主题#

使用此操作获取单个主题的信息。

输入以下参数：

• 选择用于连接的 Credential（凭据），或创建一个新的凭据。
• Resource（资源）：选择 Thread（主题）。
• Operation（操作）：选择 Get（获取）。
• Thread ID（主题 ID）：输入要检索的主题的 ID。
• Simplify（简化输出）：选择是否返回简化的响应（开启）或原始数据（关闭）。默认为开启。
  • 这相当于将 API 请求中的 format 参数设置为 metadata，此时仅返回邮件消息 ID、标签以及邮件头信息，包括：From（发件人）、To（收件人）、CC（抄送）、BCC（密送）和 Subject（主题）。

获取会话选项#

使用以下选项进一步细化节点的行为：

• 仅返回消息（Return Only Messages）：选择是否仅返回会话中的消息（开启时生效）。

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

获取多个会话#

使用此操作获取两个或更多会话。

输入以下参数：

• 选择用于连接的凭据（Credential），或创建一个新的凭据。
• 资源（Resource）：选择 Thread（会话）。
• 操作（Operation）：选择 Get Many（获取多个）。
• 返回全部（Return All）：选择节点是返回所有会话（开启）还是仅返回设定数量上限的会话（关闭）。
• 限制数量（Limit）：输入最多返回的会话数量。仅在关闭 Return All 时生效。

获取多个会话的筛选条件#

使用以下筛选条件进一步细化节点行为：

• 包含垃圾邮件和已删除邮件（Include Spam and Trash）：选择是否获取位于“垃圾邮件”和“已删除邮件”文件夹中的会话（开启）或不获取（关闭）。
• 标签名称或 ID（Label Names or IDs）：仅返回包含所选标签的会话。可以选择标签名称，或输入表达式指定标签 ID。下拉列表内容基于你选择的 Credential（凭据） 动态填充。
• 搜索（Search）：输入 Gmail 搜索筛选条件（例如 from:），以过滤返回的会话。更多信息请参考 在 Gmail 中细化搜索。
• 读取状态（Read Status）：选择接收 未读和已读邮件、仅未读邮件（默认），或 仅已读邮件。
• 接收时间之后（Received After）：仅返回在此指定日期和时间之后收到的邮件。可使用日期选择器选择具体时间，或输入表达式以 ISO 格式的字符串或毫秒级时间戳设置日期。有关字符串格式的更多信息，请参考 ISO 8601。
• 接收时间之前（Received Before）：仅返回在此指定日期和时间之前收到的邮件。可使用日期选择器选择具体时间，或输入表达式以 ISO 格式的字符串或毫秒级时间戳设置日期。有关字符串格式的更多信息，请参考 ISO 8601。

有关更多信息，请参考 Gmail API 方法：users.threads.list 文档。

从会话中移除标签#

使用此操作可从一个会话（thread）中移除标签。 输入以下参数：

• 选择要连接的 Credential（凭据） 或创建一个新的凭据。
• Resource（资源） ：选择 Thread（会话）。
• Operation（操作） ：选择 Remove Label（移除标签）。
• Thread ID（会话 ID） ：输入你想要移除标签的会话 ID。
• Label Names or IDs（标签名称或 ID） ：选择你要移除的标签名称，或输入表达式来指定其 ID。下拉列表的内容基于你所选的 Credential（凭据） 动态生成。

有关更多信息，请参考 Gmail API 方法：users.threads.modify 文档。

回复消息#

使用此操作来回复一条消息。 输入以下参数：

• 选择要连接的 Credential（凭据） 或创建一个新的凭据。
• Resource（资源） ：选择 Thread（会话）。
• Operation（操作） ：选择 Reply（回复）。
• Thread ID（会话 ID） ：输入你想要回复的会话 ID。
• Message Snippet or ID（消息片段或 ID） ：选择你要回复的消息，或输入表达式来指定其 ID。下拉列表的内容基于你所选的 Credential（凭据） 动态生成。
• 选择 Email Type（邮件类型）。可选择 Text（文本） 或 HTML。
• Message（消息内容） ：输入邮件正文内容。

回复选项#

使用这些选项进一步调整节点的行为：

• 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（资源） ：选择 Thread（会话）。
• Operation（操作） ：选择 Trash（移至回收站）。
• Thread ID（会话 ID） ：输入您想要移至回收站的会话 ID。

请参考 Gmail API 方法：users.threads.trash 文档以获取更多信息。

从回收站恢复会话#

使用此操作从回收站中恢复一个会话及其所有消息。 输入以下参数：

• 选择用于连接的 Credential（凭据） 或创建一个新的凭据。
• Resource（资源） ：选择 Thread（会话）。
• Operation（操作） ：选择 Untrash（恢复）。
• Thread ID（会话 ID） ：输入您想要从回收站恢复的会话 ID。

请参考 Gmail API 方法：users.threads.untrash 文档以获取更多信息。

常见问题#

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