WordPress + Gmail API 邮件发送配置图文教程

-

 

WordPress + Gmail API 邮件发送配置图文教程

📌 配置流程图（先看整体）

text

┌─────────────────────────────────────────────────────────────────────────────┐

│                           1. Google Cloud Console                          │

│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐            │

│  │ 创建项目  │ → │ 启用Gmail │ → │ OAuth同意 │ → │ 创建客户端│            │

│  │          │    │   API    │    │  屏幕配置  │    │  ID+密钥  │            │

│  └──────────┘    └──────────┘    └──────────┘    └──────────┘            │

└─────────────────────────────────────────────────────────────────────────────┘

                                    ↓

┌─────────────────────────────────────────────────────────────────────────────┐

│                           2. WordPress 后台                               │

│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐            │

│  │ 安装插件  │ → │ 填写凭据  │ → │ 点击授权  │ → │ 测试发送  │            │

│  └──────────┘    └──────────┘    └──────────┘    └──────────┘            │

└─────────────────────────────────────────────────────────────────────────────┘

第一部分：Google Cloud Console 配置

步骤 1：进入 Google Cloud Console 并创建项目

① 浏览器打开 https://console.cloud.google.com/

② 用你的 Gmail 账号登录

③ 点击顶部的项目下拉框 → 点击 "新建项目"

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  ☰  Google Cloud    [ ▼ 我的项目  ]  搜索  🔍    🔔   💰   👤         │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │                    选择项目或新建项目                            │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  当前项目: (无)                                        │   │   │

│  │  │  [+ 新建项目]  [所有项目]  [最近访问]                   │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  └─────────────────────────────────────────────────────────────────┘   │

└─────────────────────────────────────────────────────────────────────────┘

④ 输入项目名称，例如：WP Mail SMTP

⑤ 点击 "创建"，等待几秒

步骤 2：启用 Gmail API

① 左侧菜单 → "API 和服务" → "已启用的 API 和服务"

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  ☰  Google Cloud                         WP Mail SMTP                │

│                                                                         │

│   ┌──────────────┐  ┌─────────────────────────────────────────────┐   │

│   │ 首页          │  │  API 和服务                                │   │

│   │ 信息中心       │  │  ┌─────────────────────────────────────┐  │   │

│   │ 快速开始       │  │  │  [+ 启用 API 和服务]               │  │   │

│   │ API 和服务     │  │  ├─────────────────────────────────────┤  │   │

│   │  ▶ 已启用的API │  │  │  搜索...                           │  │   │

│   │  ▶ 凭据        │  │  │  (列表为空，还没有启用任何API)     │  │   │

│   │  ▶ OAuth同意屏 │  │  └─────────────────────────────────────┘  │   │

│   │  IAM 和管理    │  │                                          │   │

│   │  结算          │  └─────────────────────────────────────────────┘   │

│   │  更多产品      │                                                  │

│   └──────────────┘                                                    │

└─────────────────────────────────────────────────────────────────────────┘

② 点击顶部 "+ 启用 API 和服务"

③ 搜索框输入 "Gmail" → 点击搜索结果中的 "Gmail API"

④ 点击 "启用" 按钮

步骤 3：配置 OAuth 同意屏幕（⚠️ 关键步骤）

① 左侧菜单 → "API 和服务" → "OAuth 同意屏幕"

② 用户类型：选择 "外部" → 点击 "创建"

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  OAuth 同意屏幕                                                       │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  用户类型                                                       │   │

│  │  ○ 内部  → 仅组织内用户使用                                    │   │

│  │  ● 外部  → 任何 Google 账号用户都能使用   ← 选这个             │   │

│  │                                                                 │   │

│  │                    [  创 建  ]                                  │   │

│  └─────────────────────────────────────────────────────────────────┘   │

└─────────────────────────────────────────────────────────────────────────┘

③ 填写应用信息（每个字段对照填写）

text

┌─────────────────────────────────────────────────────────────────────────┐

│  应用信息                                                             │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  应用名称 *       [ WP Mail SMTP                           ]   │   │

│  │  用户支持邮箱 *   [ huay88888@gmail.com  ▼ ]                   │   │

│  │  应用徽标          [  浏览  ] (留空，不上传)                    │   │

│  │  应用首页         [ https://wpmailsmtp.com           ]         │   │

│  │  应用隐私权政策   [ https://wpmailsmtp.com/privacy-policy/ ]   │   │

│  │  应用服务条款     [ https://wpmailsmtp.com/terms-of-service/ ] │   │

│  │  已获授权的网域   [+ 添加网域]                                 │   │

│  │    └─ [ wpmailsmtp.com                                    ]   │   │

│  │  开发者联系邮箱   [ huay88888@gmail.com           ]            │   │

│  └─────────────────────────────────────────────────────────────────┘   │

│                          [ 保存并继续 ]                               │

└─────────────────────────────────────────────────────────────────────────┘

④ 点击 "保存并继续"

⑤ "目标对象" 页面：保持默认，直接点 "保存并继续"

⑥ "数据访问" 页面：不添加任何权限，直接点 "保存并继续"

⑦ 添加测试用户（⚠️ 必须做！否则会报 403 错误）

text

┌─────────────────────────────────────────────────────────────────────────┐

│  测试用户                                                             │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  发布状态: ● 测试                                              │   │

│  │  用户上限: 0 / 100                                             │   │

│  │                                                                 │   │

│  │  [+ 添加用户]                                                  │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  输入邮箱: [ huay88888@gmail.com    ]  [添加]          │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  │                                                                 │   │

│  │  已添加的测试用户:                                              │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  ✅ huay88888@gmail.com                                │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  └─────────────────────────────────────────────────────────────────┘   │

│                          [ 保存并继续 ]                               │

└─────────────────────────────────────────────────────────────────────────┘

⑧ 点击 "保存并继续" → 点击 "返回控制台"

步骤 4：创建 OAuth 2.0 客户端 ID（⚠️ 密钥只显示一次）

① 左侧菜单 → "API 和服务" → "凭据"

② 点击 "+ 创建凭据" → 选择 "OAuth 客户端 ID"

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  创建 OAuth 客户端 ID                                                 │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  应用类型 *     [ Web 应用  ▼ ]                                │   │

│  │  名称 *         [ WP Mail SMTP                          ]      │   │

│  │                                                                 │   │

│  │  已获授权的重定向 URI  ← ⚠️ 最关键的地方！                     │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  [ + 添加 URI ]                                       │   │   │

│  │  │  ┌──────────────────────────────────────────────────┐  │   │   │

│  │  │  │  https://connect.wpmailsmtp.com/google/       │  │   │   │

│  │  │  └──────────────────────────────────────────────────┘  │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  │                                                                 │   │

│  │  ⚠️ 末尾必须有斜杠 /，否则授权失败！                           │   │

│  └─────────────────────────────────────────────────────────────────┘   │

│                          [  创 建  ]                                  │

└─────────────────────────────────────────────────────────────────────────┘

③ 点击 "创建"

④ 出现弹窗：立即保存密钥！

text

┌─────────────────────────────────────────────────────────────────────────┐

│  🔑 OAuth 客户端已创建                                                │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  ⚠️ 关闭此对话框后，您将无法再查看或下载客户端密钥              │   │

│  │                                                                 │   │

│  │  客户端 ID:                                                     │   │

│  │  765833470395-1dggppjbd8g917c6sciq3b8.apps.google... │   │

│  │                                                                 │   │

│  │  客户端密钥:  ← 复制保存！                                     │   │

│  │  GOCSPX-nqjIZTwhjT2SbJjOMn                        │   │

│  │                                                                 │   │

│  │  已授权的重定向 URI:                                            │   │

│  │  https://connect.wpmailsmtp.com/google/                        │   │

│  │                                                                 │   │

│  │                    [  确 定  ]  ← 点确认前先保存！              │   │

│  └─────────────────────────────────────────────────────────────────┘   │

└─────────────────────────────────────────────────────────────────────────┘

⚠️ 关闭弹窗前，务必把客户端 ID 和客户端密钥复制到记事本保存！

第二部分：WordPress 后台配置

步骤 5：安装 WP Mail SMTP 插件

① WordPress 后台 → 插件 → 安装插件

② 搜索 "WP Mail SMTP"

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  插件 → 安装插件                                                      │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  搜索插件...  [ WP Mail SMTP  ]  [ 搜索 ]                     │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  WP Mail SMTP                                           │   │   │

│  │  │  作者: WPForms                                          │   │   │

│  │  │  评分: ⭐⭐⭐⭐⭐  (500+)                                 │   │   │

│  │  │  [ 立即安装 ]                                          │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  └─────────────────────────────────────────────────────────────────┘   │

└─────────────────────────────────────────────────────────────────────────┘

③ 点击 "立即安装" → 安装完成后点击 "启用"

步骤 6：填写 Gmail 凭据

① WordPress 后台 → WP Mail SMTP → 设置

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  WP Mail SMTP 设置                                                    │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  邮件程序                                                      │   │

│  │  [ Google / Gmail  ▼ ]  ← 选择这个                            │   │

│  │                                                                 │   │

│  │  客户端 ID *                                                    │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  765833470395-1dggppjbd8g917c6sciq3b8k6khv3dpm...     │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  │  客户端密钥 *                                                  │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  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                 │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  │  已授权的重定向 URI  (自动生成，无需填写)                      │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  https://connect.wpmailsmtp.com/google/                │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  │                                                                 │   │

│  │  ⚠️ 请确保以上信息与 Google Cloud 创建的凭据完全一致            │   │

│  └─────────────────────────────────────────────────────────────────┘   │

│                          [ 保存设置 ]                                 │

└─────────────────────────────────────────────────────────────────────────┘

② 粘贴客户端 ID 和客户端密钥

③ 点击 "保存设置"

步骤 7：授权 Google 账号

① 点击 "授权" 按钮

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  Google/Gmail                                                   │   │

│  │  状态: 未连接                                                   │   │

│  │                                                                 │   │

│  │  ⚠️ 授权您的 Google 账号以开始发送邮件。                        │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │                    [  授 权  ]                         │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  └─────────────────────────────────────────────────────────────────┘   │

└─────────────────────────────────────────────────────────────────────────┘

② 浏览器弹出 Google 登录窗口：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  Google 账号                                                          │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │                    G                                            │   │

│  │             选择账号                                            │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  👤  huay88888@gmail.com                               │   │   │

│  │  │  罗长华                                                  │   │   │

│  │  │                                                         │   │   │

│  │  │  [ 继续前往 wpmailsmtp.com ]                           │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  └─────────────────────────────────────────────────────────────────┘   │

└─────────────────────────────────────────────────────────────────────────┘

③ 点击 "继续前往 wpmailsmtp.com"

④ 出现安全警告，点击 "继续"（测试模式正常现象）

⑤ 权限确认页面，点击 "继续"

⑥ 授权成功后，页面显示：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  ✅ 您已成功将当前站点与 Google API 项目相关联。                      │

│  现在，您可以开始通过 Gmail 发送电子邮件。                            │

│                                                                         │

│  Google/Gmail                                                          │

│  状态: ● 已连接                                                       │

│  发件人邮箱: huay88888@gmail.com                                       │

└─────────────────────────────────────────────────────────────────────────┘

步骤 8：发送测试邮件

① 左侧菜单 → "电邮测试"

📷 示意图：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  电邮测试                                                             │

│  ┌─────────────────────────────────────────────────────────────────┐   │

│  │  收件人 *                                                      │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  jinchen@plasheat.com                                 │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  │  ☑ HTML 格式邮件                                               │   │

│  │  ┌─────────────────────────────────────────────────────────┐   │   │

│  │  │  [ 发送电子邮件 ]                                      │   │   │

│  │  └─────────────────────────────────────────────────────────┘   │   │

│  └─────────────────────────────────────────────────────────────────┘   │

└─────────────────────────────────────────────────────────────────────────┘

② 输入收件人邮箱（可以是自己的 QQ 邮箱或 Gmail）

③ 点击 "发送电子邮件"

④ 查看收件箱，应该收到：

text

┌─────────────────────────────────────────────────────────────────────────┐

│  寄件人: huay88888@gmail.com                                          │

│  收件人: jinchen@plasheat.com                                         │

│  主旨: WP Mail SMTP: Test email                                      │

│                                                                         │

│  ───────────────────────────────────────────────────────────────────── │

│                                                                         │

│  This email was sent from the WP Mail SMTP email test tool.           │

│                                                                         │

│  ───────────────────────────────────────────────────────────────────── │

└─────────────────────────────────────────────────────────────────────────┘

第三部分：完整配置清单（快速核对）

步骤

检查项

状态

1

Google Cloud 项目已创建

□

2

Gmail API 已启用

□

3

OAuth 同意屏幕已配置

□

4

测试用户已添加（你的 Gmail）

□

5

OAuth 客户端 ID 已创建

□

6

客户端 ID 和密钥已保存

□

7

WP Mail SMTP 插件已安装

□

8

客户端 ID 和密钥已填回插件

□

9

点击"授权"完成 OAuth 流程

□

10

测试邮件发送成功

□

第四部分：报错速查表

报错 1：403: access_denied

原因：Gmail 账号未添加到测试用户列表

解决：Google Cloud Console → OAuth 同意屏幕 → 测试用户 → 添加你的邮箱

报错 2：401: invalid_client

原因：客户端 ID/密钥不匹配，或重定向 URI 错误

解决：删除旧客户端重新创建，确保重定向 URI 末尾有 /

报错 3：Access Token: No

原因：授权流程未完成

解决：点击"授权"按钮重新走一遍流程

报错 4：发送测试邮件超时

原因：网络环境问题或令牌过期

解决：重新授权，或换一个网络环境重试

第五部分：关键提醒

text

┌─────────────────────────────────────────────────────────────────────────┐

│  ⚠️  关 键 提 醒                                                     │

│                                                                         │

│  1.  OAuth 客户端密钥只显示一次，创建后立即保存！                      │

│                                                                         │

│  2.  重定向 URI 末尾必须带斜杠：                                       │

│      ✅  https://connect.wpmailsmtp.com/google/                       │

│      ❌  https://connect.wpmailsmtp.com/google                        │

│      ❌  https://connect.wpmailsmtp.com                               │

│                                                                         │

│  3.  发件人邮箱必须与授权的 Gmail 账号一致                             │

│                                                                         │

│  4.  免费 Gmail API 每天限额 1,500-2,000 封邮件                        │

│                                                                         │

│  5.  应用处于"测试"模式时，只有添加到测试用户的邮箱才能授权            │

│                                                                         │

│  6.  如果迁移网站，需要在 Google Cloud Console 重新授权                │

└─────────────────────────────────────────────────────────────────────────┘

以上就是完整的图文教程（所有配图用字符画代替了真正的截图，确保每一步都有视觉指引）。如果还有哪一步不清楚，告诉我具体是哪一步，我单独展开解释。

 

评论

发表评论

此博客中的热门博文

S-UI面板搭建

-
先进的 Web 面板 • 基于 SagerNet/Sing-Box 构建 免责声明： 本项目仅供个人学习交流，请勿用于非法用途，请勿在生产环境使用 如果你觉得这个项目对你有帮助，不妨打个 🌟 快速概览 特征 使能够？ 多协议 ✔️ 多语言 ✔️ 多客户端/入站 ✔️ 高级流量路由接口 ✔️ 客户端 & 流量 & 系统状态 ✔️ 订阅服务 (link/json + info) ✔️ 深色/浅色主题 ✔️ API 接口 ✔️ API 文档 API 文档 Wiki 默认安装信息 面板端口：2095 面板路径：/app/ 订阅端口：2096 订阅路径：/sub/ 用户/密码：admin 安装并升级到最新版本 bash <( curl -Ls https://raw.githubusercontent.com/alireza0/s-ui/master/install.sh ) 安装旧版本 步骤 1： 要安装所需的旧版本，请将版本添加到安装命令的末尾。例如，ver  1.0.0 ： VERSION=1.0.0 && bash <( curl -Ls https://raw.githubusercontent.com/alireza0/s-ui/ $VERSION /install.sh ) $VERSION 手动安装 根据您的操作系统/架构从 GitHub 获取最新版本的 S-UI： https://github.com/alireza0/s-ui/releases/latest 可选 获取最新版本的 s-ui.sh   https://raw.githubusercontent.com/alireza0/s-ui/master/s-ui.sh 可选 复制 s-ui.sh 到 /usr/bin/ 并运行 chmod +x /usr/bin/s-ui 。 将 s-ui tar.gz 文件解压到您选择的目录，然后导航到您解压 tar.gz 文件的目录。 将 *.service 文件复制到 /etc/systemd/system/ 并运行 systemctl daemon-reload 。 启用自动启动并使用启动 S-UI 服务 systemctl enable s-ui --now 使用以下方式启动 sing-bo...
阅读全文

X-UI+宝塔Nginx反代教程：让X-UI面板与网站共存

-
图片
准备工作 VPS 一台，提前重置好主流的操作系统，推荐 CentOS ≥ 7，我这里用的是搬瓦工的VPS 域名一个，托管在Cloudflare并做好解析 自行安装 BBR 加速之类的软件 安装宝塔面板 第一步，更新系统并重启 yum update -y #更新系统 reboot #重启系统 第二步，安装宝塔面板 (PS:强烈推荐大家使用 CentOS 系统安装宝塔面板，其他系统也可以，相关安装命令请访问  宝塔官网 ) yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh 看到 Do you want to install Bt-Panel to the /www directory now?(y/n) 提示后输入英文字母 y 后自动安装。 宝塔安装完毕以后，根据提示登录宝塔面板后台，可按照自己的需求安装所需的环境插件。推荐按下图选择。 第三步，部署网站 我这边选择用WORDPRESS建站。 找到软件商店——一键部署——一键部署 WordPress 输入域名后提交即可 部署成功后会有提示，记住 数据库名 ， 用户 ， 密码 ，点击访问站点。 请自行的完成网站数据库、站点名、用户名和密码等相关的设置。 为域名申请证书 找到网站设置界面，点击SSL为网站申请证书，强制开启 HTTPS。 至此，网站已经可以使用  https  访问了 安装 X-ui 可视化面板 开始搭建 使用Github进入X-UI官方仓库 ： https://github.com/sprov065/x-ui 复制官方推荐的脚本： bash <(curl -Ls https://raw.githubusercontent.com/vaxilu/x-ui/master/install.sh) 将上述代码复制到你的VPS内执行， 如果提示未安装curl工具，请先安装curl工具 最新的版本需要自己根据提示输入账号密码和端口号，老版本默认端口为65432，这边我改成了54238. 放行宝塔面板的相关端口 找到宝塔面板 —— 安全 —— 防火墙，放行面板的默认端口 54238 ,备注说...
阅读全文