构建专业电子邮件服务：Gmail OAuth Express Webhooks

电子邮件通知对于现代 Web 应用程序至关重要。在本指南中，我们将使用 Express.js 和 Gmail 的 OAuth2 身份验证构建安全的电子邮件通知服务。我们的服务将接受 webhook 请求并根据传入数据自动发送电子邮件。

我们正在建设什么

我们将创建一个 Express 服务器：

• 通过 POST 请求接收 webhook 数据
• 使用 OAuth2 通过 Gmail 进行身份验证
• 根据 webhook 负载发送自定义电子邮件
• 优雅地处理错误

先决条件

• 您的计算机上安装了 Node.js
• 启用 Gmail API 的 Google Cloud Console 项目
• OAuth2 凭证（客户端 ID、客户端密钥、刷新令牌）
• 对 Express.js 和 async/await 的基本了解

项目设置

首先，安装所需的软件包：

npm install express body-parser nodemailer googleapis dotenv

使用您的凭据创建 .env 文件：

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret
REDIRECT_URI=your_redirect_uri
REFRESH_TOKEN=your_refresh_token
EMAIL_USER=your_email@gmail.com

---

如果您在设置这些凭据时遇到任何困难，就像我一样，您可以按照以下步骤操作...

第 1 步：创建新的 Google Cloud 项目：

a.前往 https://console.cloud.google.com/
b.单击页面顶部的项目下拉列表
c.点击“新项目”
d.输入项目名称并点击“创建”

第 2 步：启用 Gmail API：
一个。在左侧边栏中，转到“API 和服务”> “图书馆”
b.搜索“Gmail API”
c.点击“Gmail API”，然后点击“启用”

---

第 3 步：配置 OAuth 同意屏幕：
一个。转到“API 和服务”> “OAuth 同意屏幕”
b.选择“外部”作为用户类型，然后单击“创建”
c.填写必填字段：
- 应用程序名称：[您的应用程序名称]
- 用户支持电子邮件：[您的电子邮件]
- 开发者联系信息：[您的电子邮件]
d.点击“保存并继续”
e.在“范围”页面上，点击“添加或删除范围”
f.查找并选择“https://mail.google.com/”范围
g。点击“更新”，然后点击“保存并继续”
h.在“测试用户”页面，点击“添加用户”
我。添加您的 Gmail 地址并点击“保存并继续”
j。查看摘要并单击“返回仪表板”

---

第 4 步：创建 OAuth2 凭据：
一个。转到“API 和服务”> “凭证”
b.点击“创建凭证”> “OAuth 客户端 ID”
c.选择“Web应用程序”作为应用程序类型
d.名称：[您的应用名称]
e.授权的 JavaScript 来源：添加服务器的域（例如，用于本地开发的 http://localhost:3000）

f.授权重定向 URI：
- 添加：https://developers.google.com/oauthplayground
- 添加服务器的回调 URL（如果有的话）（例如，http://localhost:3000/auth/google/callback）
g。点击“创建”
h.弹出窗口将显示您的客户端 ID 和客户端密钥。安全地保存这些。

---

第 5 步：获取新的刷新令牌：
一个。前往 https://developers.google.com/oauthplayground/

b.点击右上角的齿轮图标（如设置）
c.单击复选框“使用您自己的 OAuth 凭据”
d.输入您的新客户端 ID 和客户端密钥
e.关闭设置
f.在左侧边栏中，找到“Gmail API v1”
g。选择 https://mail.google.com/
h.点击“授权API”
我。选择您的 Google 帐户并授予请求的权限
j。在下一个屏幕上，单击“将授权码兑换为令牌”
k.从响应中复制“刷新令牌”

如果您在此过程中或测试电子邮件功能时遇到任何问题，请提供您在评论中看到的具体错误消息或行为。

---

代码解释

让我们一步一步分解实现：

1. 初始设置和依赖关系

npm install express body-parser nodemailer googleapis dotenv

这部分设置我们的 Express 服务器并导入必要的依赖项。我们使用 body-parser 来解析 JSON 请求，并使用 dotenv 来管理环境变量。

2.OAuth2配置

CLIENT_ID=your_client_id
CLIENT_SECRET=your_client_secret
REDIRECT_URI=your_redirect_uri
REFRESH_TOKEN=your_refresh_token
EMAIL_USER=your_email@gmail.com

我们使用 Google 的身份验证库创建 OAuth2 客户端。这可以使用 Gmail 的 API 处理令牌刷新和身份验证。

3. 邮件发送功能

const express = require("express");
const bodyParser = require("body-parser");
const nodemailer = require("nodemailer");
const { google } = require("googleapis");
require("dotenv").config();

const app = express();
app.use(bodyParser.json());

此功能：

• 从webhook负载中提取数据，您可以根据需要修改负载
• 获取新的访问令牌
• 使用 OAuth2 身份验证创建传输
• 发送包含自定义内容的电子邮件

4.Webhook端点

const oAuth2Client = new google.auth.OAuth2(
  CLIENT_ID,
  CLIENT_SECRET,
  REDIRECT_URI
);
oAuth2Client.setCredentials({ refresh_token: REFRESH_TOKEN });

我们的 webhook 端点：

• 接收 POST 请求
• 处理 webhook 数据
• 发送电子邮件
• 返回适当的响应

测试

使用curl或Postman测试你的webhook：

npm install express body-parser nodemailer googleapis dotenv

故障排除

常见问题及解决方案：

1. 身份验证错误：检查您的 OAuth2 凭据
2. 令牌过期：确保刷新令牌有效
3. 缺少数据：验证 webhook 负载

结论

您现在拥有一个安全的、OAuth2验证的电子邮件通知系统！此实现为构建更复杂的通知系统提供了坚实的基础，同时保持安全性和可靠性。

希望这篇文章对您设置电子邮件服务有用。

编码愉快！ ？

以上是构建专业电子邮件服务：Gmail OAuth Express Webhooks的详细内容。更多信息请关注PHP中文网其他相关文章！