Gmail 节点常见问题

以下介绍 Gmail 节点的常见错误和问题，以及解决或排查步骤。

从已发送消息中移除 n8n 标识

使用节点发送消息或回复消息时，节点会在邮件末尾附加以下声明：

This email was sent automatically with n8n（此电子邮件由 n8n 自动发送）

要移除此标识：

1. 在节点的 Options（选项）部分选择 Add option（添加选项）。
2. 选择 Append n8n attribution（附加 n8n 标识）。
3. 关闭开关。

更多信息，请参阅发送选项和回复选项。

Forbidden - perhaps check your credentials（禁止访问，请检查凭据）

此错误显示在节点的某些下拉菜单旁，例如 Label Names or IDs（标签名称或 ID）。完整错误文本类似于：

There was a problem loading the parameter options from server: "Forbidden - perhaps check your credentials?"

最常见的原因是使用了 Google 服务账户凭据，但未开启凭据中的 Impersonate a User（模拟用户）。

更多信息，请参阅 Google 服务账户：完成 n8n 凭据设置。

401 unauthorized（未授权）错误

完整错误文本如下：

401 - {"error":"unauthorized_client","error_description":"Client is unauthorized to retrieve access tokens using this method, or client not authorized for any of the scopes requested."}

所用凭据及其作用域或权限存在问题时，会出现此错误。

解决方法：

1. 对于 OAuth2 凭据，请确认已在 APIs & Services > Library（API 和服务 > 库）中启用 Gmail API。更多信息，请参阅 Google OAuth2 单服务：启用 API。
2. 对于服务账户凭据：
   1. 启用全域委派。
   2. 确认已将 Gmail API 添加到全域委派配置中。

Bad request - please check your parameters（请求无效，请检查参数）

此错误通常是因为输入的消息 ID、邮件线程 ID 或标签 ID 不存在。

尝试使用该 ID 执行 Get（获取）操作，确认其是否存在。