Google Calendar API v3 eventType参数在Java客户端中的使用疑问

核心原因 #

Google API Java/Scala客户端库的自动生成逻辑有时会滞后于API的参数更新，即便你已升级到v3-rev411-1.25.0版本，也可能没有为Events.List和Events.Watch生成直接的setEventType()方法，但该参数本身已被API支持，需通过通用参数设置方式传递。

解决方案 #

1. 为Events.List请求设置eventType #

使用请求对象的通用set()方法手动添加参数：

// Scala语法只需调整变量定义方式
Events.List listReq = calendar.events().list("primary");
// 替换为目标事件类型："default"/"workingLocation"/"outOfOffice"/"focusTime"
listReq.set("eventType", "default");
Events events = listReq.execute();

2. 为Events.Watch请求设置eventType #

同样通过通用set()方法传递参数：

Channel channel = new Channel();
channel.setId(UUID.randomUUID().toString());
channel.setType("web_hook");
channel.setAddress("你的回调URL");

Events.Watch watchReq = calendar.events().watch("primary", channel);
watchReq.set("eventType", "default"); // 指定要订阅的事件类型
Channel response = watchReq.execute();

3. 确认支持的eventType取值 #

根据官方变更通知，支持的事件类型包括：

• default：常规事件（默认值）
• workingLocation：工作位置事件
• outOfOffice：外出事件
• focusTime：专注时间事件

4. 验证参数是否生效 #

可开启客户端请求日志，检查最终发送的URL是否包含eventType参数，确保参数正确传递：

HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
JsonFactory jsonFactory = JacksonFactory.getDefaultInstance();

// 开启请求日志
HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor();
loggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);

HttpRequestInitializer requestInitializer = request -> {
    request.setInterceptor(loggingInterceptor);
    // 此处添加OAuth2认证等初始化逻辑
};

Calendar calendar = new Calendar.Builder(httpTransport, jsonFactory, requestInitializer)
        .setApplicationName("你的应用名称")
        .build();

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