Java环境下如何利用已有Access Token创建Gmail对象？

嘿，我来帮你搞定这个问题！既然你已经通过OAuth Playground拿到了Access Token，那在Java里创建Gmail服务对象其实挺直接的，核心是借助Google官方的Gmail客户端库配置认证信息就行。

首先，确保你已经引入了Google Gmail客户端的Java依赖。如果用Maven管理项目，直接在pom.xml里添加以下依赖：

<dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-gmail</artifactId>
    <version>v1-rev20240409-2.0.0</version> <!-- 建议替换成最新版本 -->
</dependency>
<dependency>
    <groupId>com.google.auth</groupId>
    <artifactId>google-auth-library-oauth2-http</artifactId>
    <version>1.20.0</version> <!-- 配套的认证库，版本尽量和客户端库兼容 -->
</dependency>

接下来是核心代码实现，我们需要用已有的Access Token构建GoogleCredentials，再基于它创建Gmail实例：

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

import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.Collections;

public class OfflineGmailBatchApp {
    public static void main(String[] args) throws GeneralSecurityException, IOException {
        // 替换成你从OAuth Playground获取的Access Token
        String yourAccessToken = "YOUR_ACCESS_TOKEN_VALUE";
        // 离线批处理建议同时保存Refresh Token，方便Token过期后自动刷新
        // String yourRefreshToken = "YOUR_REFRESH_TOKEN_VALUE";

        // 构建AccessToken对象，第二个参数为过期时间，传null会自动使用Token本身的过期信息
        AccessToken accessToken = new AccessToken(yourAccessToken, null);

        // 构建认证凭据
        GoogleCredentials credentials = GoogleCredentials.create(accessToken)
                // 这里要和你在OAuth Playground申请Token时的作用域保持一致
                .createScoped(Collections.singleton(GmailScopes.GMAIL_SEND));
                // 示例：如果是只读需求就用GmailScopes.GMAIL_READONLY，全权限用GmailScopes.MAIL_GOOGLE_COM

        // 初始化Gmail服务对象
        Gmail gmailService = new Gmail.Builder(GoogleNetHttpTransport.newTrustedTransport(),
                        GsonFactory.getDefaultInstance(),
                        credentials)
                .setApplicationName("你的离线批处理Gmail应用") // 设置你的应用名称，便于Google API识别
                .build();

        // 现在就可以用gmailService调用各种Gmail API了，比如获取邮件标签
        // ListLabelsResponse labelResponse = gmailService.users().labels().list("me").execute();
        // System.out.println("获取到的标签：" + labelResponse.getLabels());
    }
}

几个关键提示： #

• 作用域必须匹配：代码中createScoped设置的作用域，一定要和你在OAuth Playground申请Token时勾选的作用域完全一致，否则会触发权限错误。
• Token过期处理：Access Token通常只有1小时有效期，离线批处理场景下强烈建议保存Refresh Token。如果有Refresh Token，构建凭据时可以这样写，方便自动刷新：

  GoogleCredentials credentials = GoogleCredentials.newBuilder()
          .setAccessToken(accessToken)
          .setRefreshToken(new com.google.auth.oauth2.RefreshToken(yourRefreshToken))
          .createScoped(Collections.singleton(GmailScopes.GMAIL_SEND))
          .build();
  // 后续需要时调用credentials.refreshIfExpired()即可自动刷新Token
  

• 依赖版本更新：尽量使用最新的客户端库版本，避免出现兼容性问题，可以去Maven仓库查询最新版本号。

内容的提问来源于stack exchange，提问作者Wei Chen