如何调用GMAIL API无需授权提示获取邮件？

完全可以实现无授权提示的自动化调用，针对你的自动化测试场景，有两种主流方案，分别适配不同的邮箱类型：

方案一：服务账号+域范围授权（适用于Google Workspace账号） #

如果目标邮箱是Google Workspace（原G Suite）账号，推荐用服务账号模拟目标邮箱身份，全程无需用户交互：

操作步骤 #

1. 创建服务账号并下载密钥

   • 登录Google Cloud控制台，进入「IAM与Admin > 服务账号」页面，创建新服务账号。
   • 为该账号生成并下载JSON格式的密钥文件，妥善保存。

2. 启用Gmail API

   • 在Cloud控制台的「API库」中搜索并启用Gmail API。

3. 配置域范围授权

   • 登录Google Workspace Admin控制台，进入「安全 > API控制 > 域范围授权」。
   • 添加新的客户端ID（即服务账号的客户端ID），并授予所需的Gmail权限（比如https://www.googleapis.com/auth/gmail.readonly），同时指定要模拟的目标邮箱地址。

Java代码示例 #

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.gmail.Gmail;
import com.google.api.services.gmail.GmailScopes;

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

public class GmailWorkspaceAutomation {
    private static final String APP_NAME = "Gmail自动化测试";
    private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
    private static final String SERVICE_KEY_PATH = "path/to/your/service-account-key.json";
    private static final String TARGET_EMAIL = "test-user@your-domain.com";

    public static Gmail getGmailService() throws Exception {
        GoogleCredential credential = GoogleCredential.fromStream(new FileInputStream(SERVICE_KEY_PATH))
                .createScoped(Collections.singleton(GmailScopes.GMAIL_READONLY))
                .createDelegated(TARGET_EMAIL);

        return new Gmail.Builder(GoogleNetHttpTransport.newTrustedTransport(), JSON_FACTORY, credential)
                .setApplicationName(APP_NAME)
                .build();
    }

    public static void main(String[] args) throws Exception {
        Gmail service = getGmailService();
        // 查询收件箱邮件，可添加过滤条件（如主题、发件人）
        var inboxMessages = service.users().messages().list(TARGET_EMAIL).setQ("in:inbox").execute();
        System.out.println("收件箱邮件数量：" + inboxMessages.getResultSizeEstimate());
    }
}

方案二：刷新令牌（适用于个人Gmail账号） #

如果目标邮箱是个人Gmail账号，无法使用域范围授权，可通过一次性手动授权获取刷新令牌，后续用该令牌自动获取访问令牌，实现无交互调用：

操作步骤 #

1. 创建OAuth客户端ID

   • 在Google Cloud控制台的「API与服务 > 凭据」页面，创建「OAuth客户端ID」，选择「桌面应用」类型，下载客户端密钥JSON文件。

2. 手动获取刷新令牌

   • 运行一次带offline访问类型的授权流程，完成登录授权后，保存返回的refresh_token（该令牌长期有效，除非用户撤销授权）。

Java代码示例 #

import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.gmail.Gmail;
import com.google.api.services.gmail.GmailScopes;

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

public class GmailPersonalAutomation {
    private static final String APP_NAME = "Gmail自动化测试";
    private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
    private static final String CLIENT_SECRET_PATH = "path/to/client-secret.json";
    private static final String REFRESH_TOKEN = "your-saved-refresh-token";
    private static final String USER_ID = "me"; // 个人账号用"me"指代当前授权用户

    public static Gmail getGmailService() throws Exception {
        GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(JSON_FACTORY,
                new InputStreamReader(new FileInputStream(CLIENT_SECRET_PATH)));

        GoogleCredential credential = new GoogleCredential.Builder()
                .setTransport(GoogleNetHttpTransport.newTrustedTransport())
                .setJsonFactory(JSON_FACTORY)
                .setClientSecrets(clientSecrets)
                .build()
                .setRefreshToken(REFRESH_TOKEN);

        credential.refreshToken(); // 自动刷新获取新的访问令牌

        return new Gmail.Builder(GoogleNetHttpTransport.newTrustedTransport(), JSON_FACTORY, credential)
                .setApplicationName(APP_NAME)
                .build();
    }

    public static void main(String[] args) throws Exception {
        Gmail service = getGmailService();
        var inboxMessages = service.users().messages().list(USER_ID).setQ("in:inbox").execute();
        System.out.println("收件箱邮件数量：" + inboxMessages.getResultSizeEstimate());
    }
}

关键注意事项 #

• 权限最小化：仅申请测试所需的权限（如只读权限GMAIL_READONLY），避免过度授权。
• 密钥安全：服务账号密钥、客户端密钥和刷新令牌均为敏感信息，请勿提交到公开版本控制系统，建议通过环境变量加载。
• 令牌有效期：服务账号的访问令牌默认有效期1小时，代码会自动刷新；个人账号的刷新令牌长期有效，除非用户在Google账号设置中撤销应用授权。

内容的提问来源于stack exchange，提问作者Pavel.G