Google Workspace管理员如何在Java后端服务中以指定域用户身份通过OAuth2无交互发送Gmail邮件

阿华AIGC实验室

2026-4-16

作为同样管理过Google Workspace域、处理过类似后台发信需求的管理员，我完全懂你现在的痛点——原来用账号密码发信的方式要被淘汰了，而且你的场景是服务端直接以固定域用户身份发信，不需要任何用户交互，这种情况最适合用服务账号+域范围委派的方案，这也是Google官方推荐给Workspace后台服务的无交互OAuth2认证方式。下面我一步步给你讲怎么操作：

一、前期控制台配置

1. 创建Google Cloud服务账号并生成密钥

登录Google Cloud控制台，创建一个新项目（或使用已有项目）
进入「IAM与管理」→「服务账号」页面，新建一个服务账号（比如命名为gmail-server-sender）
进入该服务账号的「密钥」页，点击「添加密钥」→「创建新密钥」，选择JSON格式，下载生成的密钥文件，存到服务端安全位置（务必妥善保管，不能泄露）

2. 配置域范围委派权限

登录Google Workspace管理控制台，进入「安全」→「API控制」→「域范围委派」
点击「添加新的客户端ID」，填入刚才创建的服务账号的客户端ID（可在Cloud控制台服务账号详情页找到）
在「OAuth范围」中填入Gmail发信所需权限：https://www.googleapis.com/auth/gmail.send（遵循最小权限原则，只给必要权限）
保存配置后，等待5-10分钟让权限生效

3. 启用Gmail API

回到Google Cloud控制台，在「API与服务」→「库」中搜索「Gmail API」，点击启用该API

二、Java代码实现（基于官方示例修改）

官方的SendMessage.java是面向用户授权的场景，我们需要把认证逻辑改成服务账号模拟指定用户的方式。以下是核心实现：

首先确保项目依赖Google客户端库（Maven示例）：

<dependencies>
    <dependency>
        <groupId>com.google.oauth-client</groupId>
        <artifactId>google-oauth-client-java6</artifactId>
        <version>1.34.1</version>
    </dependency>
    <dependency>
        <groupId>com.google.apis</groupId>
        <artifactId>google-api-services-gmail</artifactId>
        <version>v1-rev20230515-2.0.0</version>
    </dependency>
    <dependency>
        <groupId>com.google.auth</groupId>
        <artifactId>google-auth-library-oauth2-http</artifactId>
        <version>1.19.0</version>
    </dependency>
</dependencies>

然后修改认证与发信逻辑：

import com.google.auth.oauth2.GoogleCredentials;
import com.google.auth.oauth2.ServiceAccountCredentials;
import com.google.api.services.gmail.Gmail;
import com.google.api.services.gmail.GmailScopes;
import com.google.api.services.gmail.model.Message;

import java.io.FileInputStream;
import java.io.IOException;
import java.util.Collections;

public class SendGmailAsServiceAccount {
    // 替换为你的服务账号密钥文件路径
    private static final String SERVICE_ACCOUNT_KEY_PATH = "/path/to/your/service-account-key.json";
    // 替换为要模拟的域用户邮箱
    private static final String USER_TO_IMPERSONATE = "XXXX@mydomain.com";

    public static Gmail createGmailService() throws IOException {
        // 加载服务账号密钥，配置模拟用户与权限
        GoogleCredentials credentials = ServiceAccountCredentials.fromStream(
                new FileInputStream(SERVICE_ACCOUNT_KEY_PATH))
                .createDelegated(USER_TO_IMPERSONATE)
                .createScoped(Collections.singleton(GmailScopes.GMAIL_SEND));

        // 构建Gmail服务实例
        return new Gmail.Builder(
                com.google.api.client.googleapis.javanet.GoogleNetHttpTransport.newTrustedTransport(),
                com.google.api.client.json.gson.GsonFactory.getDefaultInstance(),
                new com.google.api.client.googleapis.auth.oauth2.GoogleCredential.Builder()
                        .setTransport(com.google.api.client.googleapis.javanet.GoogleNetHttpTransport.newTrustedTransport())
                        .setJsonFactory(com.google.api.client.json.gson.GsonFactory.getDefaultInstance())
                        .setServiceAccountId(((ServiceAccountCredentials) credentials).getClientEmail())
                        .setServiceAccountPrivateKey(((ServiceAccountCredentials) credentials).getPrivateKey())
                        .setServiceAccountScopes(Collections.singleton(GmailScopes.GMAIL_SEND))
                        .setServiceAccountUser(USER_TO_IMPERSONATE)
                        .build())
                .setApplicationName("Gmail Server Sender")
                .build();
    }

    // 复用官方发信逻辑，传入构建好的Gmail服务实例
    public static Message sendMessage(Gmail service, String userId, Message content) throws IOException {
        return service.users().messages().send(userId, content).execute();
    }

    public static void main(String[] args) throws Exception {
        Gmail service = createGmailService();
        // 参考官方示例构造邮件内容，转换为Message对象
        Message message = ...;
        sendMessage(service, USER_TO_IMPERSONATE, message);
    }
}