Java中整合Google Calendar客户端与GoogleCredentials遇类型转换错误求助

错误原因 #

com.google.auth.oauth2.ServiceAccountCredentials（新版Google Auth库类）与com.google.api.client.http.HttpRequestInitializer（旧版Google API Client库接口）分属不同类体系，无继承/实现关系，直接强制类型转换必然触发ClassCastException。

解决方法 #

使用Google官方提供的适配类，将新版GoogleCredentials转换为旧版HttpRequestInitializer实例，同时为服务账号凭证指定Calendar API的权限范围。

步骤1：确认依赖完整性 #

确保项目包含以下核心依赖（以Maven为例）：

<!-- Google Calendar API 核心依赖 -->
<dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-calendar</artifactId>
    <version>v3-rev20240109-2.0.0</version>
</dependency>
<!-- Google 新版认证库 -->
<dependency>
    <groupId>com.google.auth</groupId>
    <artifactId>google-auth-library-oauth2-http</artifactId>
    <version>1.20.0</version>
</dependency>
<!-- Google 旧版API客户端库 -->
<dependency>
    <groupId>com.google.api-client</groupId>
    <artifactId>google-api-client</artifactId>
    <version>2.2.0</version>
</dependency>

步骤2：修改代码实现 #

替换强转逻辑，用适配类包装凭证，并指定API权限范围：

package com.example;

import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.calendar.Calendar;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.auth.http.HttpCredentialsAdapter;

import java.io.FileInputStream;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.Arrays;

public class Main {

    public static void main(String[] args) throws GeneralSecurityException, IOException {
        // 加载服务账号凭证，指定Calendar API只读权限范围
        GoogleCredentials credentials = GoogleCredentials.fromStream(new FileInputStream("target/classes/credentials.json"))
                .createScoped(Arrays.asList("https://www.googleapis.com/auth/calendar.readonly"));

        // 将新版凭证适配为HttpRequestInitializer实例
        HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(credentials);

        // 创建Calendar客户端
        Calendar client = new Calendar.Builder(GoogleNetHttpTransport.newTrustedTransport(), 
                GsonFactory.getDefaultInstance(), requestInitializer)
                .setApplicationName("Your-Calendar-App") // 替换为你的应用名称
                .build();

        // 调用API获取日历列表
        System.out.println(client.calendarList().list().execute());
    }
}

关键注意点 #

• 适配类版本对应：部分旧版认证库中适配类名为GoogleCredentialsAdapter，请根据依赖版本调整。HttpCredentialsAdapter是新版库的标准适配类。
• 权限范围必须指定：服务账号凭证必须绑定对应API的权限范围，否则会触发权限不足错误。常用Calendar范围：
  • https://www.googleapis.com/auth/calendar.readonly：只读访问
  • https://www.googleapis.com/auth/calendar：全读写访问
• 服务账号授权：若访问特定用户的日历，需在Google Cloud控制台启用Calendar API，并将服务账号邮箱添加到目标日历的共享列表中。

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