如何在 WP Mail SMTP 中设置 Google Gmail

您想使用您的 Gmail 或 Google Workspace(以前称为 G Suite)帐户来解决您网站上的电子邮件递送问题吗?WP Mail SMTP 的 Google Workspace / Gmail 选项使用 Google 的 API 来安全地验证您网站的电子邮件,帮助它们成功到达您用户的收件箱。

在本教程中,我们将向您展示如何使用 Google Workspace / Gmail 邮件程序和您的 Gmail 或 Google Workspace 电子邮件地址设置 WP Mail SMTP。

  1. 安装和配置 WP Mail SMTP 插件
  2. 在您的 Google 帐户中创建网络应用程序
    • 创建或选择项目
    • 启用 Gmail API
    • 创建应用程序的凭据
    • 配置您的 OAuth 同意屏幕
    • 配置范围(可选)
    • 设置您的 OAuth 客户端 ID
  3. 将发布状态从测试更新到生产
  4. 授予您的网站 Google/Gmail 权限
  5. 发送测试电子邮件
  6. 经常问的问题

1. 安装和配置 WP Mail SMTP 插件

在开始之前,您需要安装并激活 WP Mail SMTP 插件。

验证许可证后,您就可以配置插件的设置了。您可以通过转到WP Mail SMTP » 设置并在“常规”选项卡下查看来找到它们。

常规选项卡 SMTP 设置

下面,我们将介绍此设置所需的设置。

从电子邮件

这是发送您网站所有电子邮件的电子邮件地址。您可以在提供的字段中输入您的电子邮件地址,或者在后续步骤中将您的站点连接到 Gmail API 后出现的下拉列表中选择您想要使用的电子邮件地址(包括您配置的任何别名)。

在设置 Google/Gmail 邮件程序后选择一个电子邮件地址用作您的发件人电子邮件

Force From Email选项将使从您的站点发送的 所有电子邮件都来自您输入或选择的地址。

注意:要在整个 WordPress 站点中使用多个 Gmail 别名作为发件人电子邮件地址,请确保未选中强制发件人复选框。

来自名字

在 From Email 下方,您可以设置From Name。这是与您的网站发送的电子邮件相关联的名称。默认情况下,它将设置为您网站的名称,但您可以将其调整为您想要的任何名称。

您还可以选中Force From Name选项以在站点范围内应用此设置。

来自 WP Mail SMTP 设置中的名称

梅勒

您可以在此处选择希望站点使用的邮件程序。选择谷歌/Gmail选项。

在 WP Mail SMTP 的设置中选择 Google / Gmail 邮件程序

选择此邮件程序后,您应该会看到一个标题为Google / Gmail的新部分。在本节中,有标记为 Client IDClient Secret的设置。

Google/Gmail 邮件设置

要生成这些字段所需的信息,您需要使用您的 Google 帐户来创建 Web 应用程序。此过程不需要任何编码,我们将在下一步中准确地向您展示要做什么。

稍后您将返回 WP Mail SMTP 的设置页面,因此对于下一步,请在浏览器中打开一个新选项卡或窗口。

2. 在您的 Google 帐户中创建 Web 应用程序

在您打开的新标签页或窗口中,登录您的 Google 帐户并打开您的Google Cloud Console

注意:在继续之前,请务必退出除您将用于 SMTP 设置的帐户之外的所有其他 Google 帐户。

此外,如果您使用的是 Google Workspace,请确保您使用的 Google 帐户有权发送电子邮件(换言之,有权访问其自己的收件箱)。

如果这是您第一次使用 Google Cloud Console,您可能会看到一个弹出窗口,要求您选择您的国家并同意服务条款。继续这样做,然后单击“同意并继续”以继续下一步。

接受 Google Cloud 服务条款

如果您之前登录过 Google Cloud Console,您可能会绕过服务条款。

创建或选择项目

首先,您需要为您的应用选择一个项目。您可以选择一个现有的或创建一个新的。

为此,请单击仪表板顶部工具栏中的项目下拉菜单。

打开 Google Cloud 项目下拉菜单

在出现的弹出窗口中,从列表中选择一个现有项目或单击右上角的 新建项目

选择在 Google Cloud 中为应用设置新项目

如果您选择了现有项目,请继续下一步。对于新项目,输入项目名称并从下拉列表中选择组织和位置。

在 Google Cloud 中创建新项目

然后单击 创建按钮。

启用 Gmail API

接下来,您需要为您的项目启用 Gmail API。在您的 Google Cloud Console 侧边栏中,转到 APIs & Services » Library

然后在 类别下查看并单击 电子邮件,或在搜索栏中输入“Gmail API”。

在 Google API 库中打开电子邮件类别

单击 Gmail API结果。

Gmail API

在 Gmail API 页面上,单击蓝色的 启用按钮。

启用 Gmail API

创建应用程序的凭据

启用 Gmail API 后,您应该会被重定向到 Gmail API 概览页面。在这里,单击创建凭据按钮。

为 Gmail API 创建凭据

在下一页上,Google 将询问几个问题来确定您需要的凭据类型。从Select an API下拉列表中,选择Gmail API

选择 Gmail API

注意:如果您在下拉列表中没有看到 Gmail API 选项,请确保您已为您的帐户启用了 Gmail API 。

接下来,在您将访问哪些数据?,选择用户数据选项。然后单击下一步按钮继续。

单击下一步按钮

然后,Google 会询问您的应用的一些基本信息。

此部分主要供个人使用,因为没有其他人会使用您的应用程序。但是,某些字段仍标记为必填:

  • 应用名称:输入您选择的应用名称(例如,Pattie 的应用)。
  • 用户支持电子邮件:从提供的选项中选择您的电子邮件地址。
  • 应用徽标:如果您愿意,可以为您的应用上传徽标。这是可选的。
在 Google Cloud 中输入应用信息

后,在电子邮件地址字段中添加您的电子邮件地址。然后单击“保存并继续”按钮继续下一步。

单击保存并继续按钮

配置范围(可选)

这是一个可选步骤,我们将在本教程中跳过。向下滚动到“范围”部分的末尾,然后单击“保存并继续 ”按钮继续。

继续通过 Google Cloud 范围设置

注意:有关 Gmail API 范围的更多信息,请参阅 Google 的开发者文档

设置您的 OAuth 客户端 ID

接下来,您需要填写一些有关您的 OAuth 客户端 ID 的信息。

应用程序类型下拉列表中,选择Web 应用程序选项。这样做后,将自动填充更多字段。

选择网络应用程序

您可以将名称字段保留为默认值或将其更改为更相关的内容。对于此示例,我们将保留默认名称Web 客户端 1

OAuth 名称

接下来,跳过Authorized JavaScript origins部分并滚动到Authorized redirect URIs

单击+ 添加 URI按钮并输入以下内容:https://connect.wpmailsmtp.com/google/。如果您愿意,您也可以从您的 WP Mail SMTP 设置中复制此值并将其粘贴到此处。

URI 的输入

然后单击CREATE按钮完成此步骤。

点击创建按钮

创建您的应用程序后, 您的凭据部分将展开以显示您的客户 ID。现在不需要复制它,因为您将在稍后的步骤中从另一个区域访问它。

相反,请继续并单击页面底部的“完成”按钮。

点击完成按钮

3. 将发布状态从测试更新到生产

默认情况下,Google 会将您的应用置于内部模式。将其切换到外部模式并发布它非常重要。否则,您的应用程序将受到超级限制并且无法正常运行。

在您的 Google Cloud Console 侧边栏中,转到APIs & Services » OAuth 同意屏幕。在 User Type下,单击 Make External按钮。

点击 MAKE EXTERNAL 按钮更改 Google Cloud 应用的发布状态

在出现的弹出窗口中,选择 In production选项。然后点击确认

将 Google Cloud 应用发布状态设置为生产中

确认完成后,您会看到应用的 Publishing 状态现在为In production

检查 Google Cloud 应用的发布状态

4. 授予您的网站 Google/Gmail 权限

接下来,单击左侧菜单中的凭据。

进入凭据页面后,在OAuth 2.0 客户端 ID部分中,您可以看到刚刚创建的 Web 应用程序的详细信息。要查看Client IDClient Secret,请单击铅笔图标。

单击铅笔图标

这将打开您的应用程序的所有详细信息。在此页面的右侧,您将看到客户端 ID客户端密码值。

客户端 ID 和客户端密码

继续将这两个值复制到 WP Mail SMTP 设置中的相应字段中。

在 Google/Gmail 邮件设置中粘贴您的客户端 ID 和客户端密码

注意:请非常小心,不要使用您的客户端 ID 或客户端密码复制任何额外的文本或空格,因为这将导致下一步出错。

添加这些值后,单击页面底部的保存设置按钮。

保存设置按钮

保存设置后,页面将刷新。在 Google 允许我们的插件使用您的 Gmail API 发送电子邮件之前,您必须授予权限。

为此,请滚动到 WP Mail SMTP 设置页面的底部,然后单击标有Allow plugin to send emails using your Google account的按钮。

授权插件使用 Gmail 发送电子邮件

这将为 Google 打开一个登录屏幕。继续并登录到您设置 SMTP 的帐户。

接下来,您将看到一个屏幕,请求允许此站点代表您发送电子邮件。

准备好后,单击“允许”按钮继续。

允许您的网站从您的 Google 帐户发送电子邮件

绕过 Google 的验证警告(仅限免费 Gmail 用户)

如果您使用免费的 Gmail 帐户连接,您可能会看到以下屏幕。继续并单击左下角的链接。

Gmail OAuth 警告

在展开的部分中,单击Go to wpmailsmtp.com (unsafe)。不用担心,Google 只会显示此警告,因为它尚未验证您的应用。无需验证,因为您创建此应用程序仅供您自己使用。

Gmail OAuth 显示

然后点击 允许按钮,如上图所示。

5. 发送测试邮件

接下来,您将返回到您的 WP Mail SMTP 设置,并显示一条成功消息。连接完成后,您就可以发送测试电子邮件了。为此,请导航至WP Mail SMTP » 工具并打开电子邮件测试选项卡。

WP Mail SMTP 中的电子邮件测试选项卡

打开“电子邮件测试”选项卡后,您需要输入可以访问其收件箱的电子邮件地址。除非您确定只会从您的站点发送纯文本电子邮件,否则我们建议您将 HTML设置 保留为ON。然后单击发送电子邮件按钮。

点击发送电子邮件按钮

发送测试电子邮件后,您将看到一条成功消息。

WP Mail SMTP 测试邮件成功消息

您也应该很快会通过您输入的电子邮件地址收到测试电子邮件。

来自 WP Mail SMTP 的成功测试电子邮件

经常问的问题

这些是我们收到的关于设置 Google Workspace/Gmail 邮件程序的一些主要问题。

如果测试邮件没有发送成功怎么办?

如果 SMTP 测试电子邮件无法发送,则会显示带有其他详细信息的调试日志。以下是一些可能的错误消息以及解决方法。

401. That’s an error.
Error: invalid_client

当无法正确读取客户端 ID 时会出现此错误。要解决此问题,请尝试再次复制并粘贴您的客户 ID,并检查是否没有空格或多余的文本。

400. That’s an error.
Error: invalid_request
Missing required parameter: client_id

当客户端 ID 字段为空或无法正确读取时,将显示此错误。要解决此问题,请尝试再次复制并粘贴您的客户 ID,并检查是否没有空格或多余的文本。

cURL error 60: SSL certificate problem

此消息意味着服务器缺少 SMTP 工作所需的证书。要解决此问题,您需要联系您网站的托管服务提供商,要求他们安装此证书(很可能是 cacert.pem 证书,但好让您的托管服务商检查)。

“code”: 401,
“message”: “Login Required”

如果您在调试消息中看到这一点,您仍然需要授予 WP Mail SMTP 访问您的 Google 帐户的权限。有关如何解决此问题的说明,请参阅本教程的第 4 步。此外,请务必检查 SMTP 设置中的“发件人电子邮件”是否与用于设置 Google 应用的电子邮件相匹配。

Request Entity Too Large
Error 413

如果您看到此错误,很可能是通过您的表单发送的文件超出了 Gmail 对电子邮件中直接文件附件的限制。此限制适用于邮件文本和编码附件的总和。为防止出现此错误,您需要确保所有文件不超过 22 MB。

There was a problem while retrieving Auth for gmail: Could not json decode the token

此错误可能表明另一个插件(例如 UpdraftPlus)正在站点上加载不同版本的 Google API,从而产生冲突。如果可能,应停用有冲突的插件。否则,建议您设置不同的邮件程序

如果以上均不适用,或者测试电子邮件仍无法正常工作,则您的 Google 帐户可能禁用了 Gmail API。要检查这一点,请按照Google 的启用 API 指南进行操作

如果我看到显示“此应用未验证”的屏幕怎么办?

当您单击 WP Mail SMTP 设置中的允许插件使用您的 Google 帐户发送电子邮件按钮时,Google 可能会显示一个屏幕,显示“此应用未验证。此应用尚未经过 Google 验证。只有在您了解并信任开发人员的情况下才能继续。”

不过,没有必要担心。此消息仅指您在自己的 Google 帐户中创建的应用程序,因此在这种情况下您实际上是开发人员。

要绕过此消息,请单击,然后单击转到 wpmailsmtp.com(不安全)

Gmail OAuth 显示
如果我想稍后切换到其他电子邮件怎么办?

如果您想更改为其他 Gmail 或 Google Workspace 电子邮件地址,则需要重复上述所有教程步骤。这包括在此其他电子邮件帐户下生成新的客户 ID 和客户密码。

当您进入授权步骤(步骤 4)时,保存您的设置并单击删除连接按钮。这将删除您原始电子邮件帐户的授权,并允许您对新电子邮件重复授权步骤。

删除 WP Mail SMTP 中的连接
G Suite / Gmail 邮件程序是否支持别名?

是的,截至 2020 年 7 月,WP Mail SMTP 支持 Gmail 别名。有关如何在 Google 中设置别名的更多详细信息,请查看其关于如何从别名发送电子邮件的指南。

如果我在我的 Google 帐户上启用了 2 因素身份验证 (2FA),我可以使用 Google Workspace / Gmail 邮件吗?

您可以将 2 Factor Authentication 与 WP Mail SMTP 的 Google Workspace / Gmail 选项一起使用。但是,请务必注意,如果您选择禁用 2FA 或更改帐户密码,则需要再次完成设置过程

授权我的应用程序时,我收到以下错误消息:

Error 403: access_denied. The developer hasn’t given you access to this app.

此消息表示您的应用的权限已设置为 Google Cloud 中的测试模式。

要解决此问题,请务必将模式从测试切换到生产,并尝试再次授权您的应用程序。

我是否需要将我的应用程序提交给 Google 进行验证才能与 WP Mail SMTP 一起使用?

您无需提交应用程序进行验证。但是,如果您愿意,欢迎您这样做。如果您选择提交您的应用程序进行验证,您可以在 WP Mail SMTP 中继续授权过程, 而无需等待 Google 的验证。

就是这样!现在您知道如何在您的 WordPress 网站上设置 WP Mail SMTP 的 Google Workspace / Gmail 邮件程序了。

接下来,您想知道如何有效地解决 WP Mail SMTP 中的问题吗?请务必查看我们的WP Mail SMTP 故障排除教程以获取更多详细信息。

滚动至顶部