Google Calendar API中‘primary’日历ID无法使用的问题咨询

核心问题原因 #

你遇到的情况是因为服务账号模拟用户身份时，代码中重复设置日历ID引发逻辑冲突，同时需确认权限配置的有效性。

1. 代码调用的错误 #

你的代码同时使用了.list("")和.setCalendarId("primary")，虽然理论上setCalendarId会覆盖list方法传入的空字符串，但这种重复设置可能导致客户端SDK无法正确识别primary作为目标日历ID。

2. 权限验证补充 #

尽管已将个人日历共享给服务账号邮箱，仍需确认共享权限至少为「查看所有事件」（只读场景），确保服务账号模拟用户时能正常访问主日历。

修正步骤 #

步骤1：调整API调用代码 #

修改事件列表查询逻辑，避免重复设置日历ID，二选一即可：

方式一：直接在list方法中传入primary

public void listEvent() {
  try {
    DateTime now = new DateTime(System.currentTimeMillis());
    Events events = calendar.events()
            .list("primary") // 直接传入primary作为日历ID
            .setMaxResults(5)
            .setTimeMin(now)
            .setOrderBy("startTime")
            .setSingleEvents(true)
            .execute();
    List<Event> items = events.getItems();
    if (items.isEmpty()) {
      System.out.println("No upcoming events found.");
    } else {
      System.out.println("Upcoming events");
      for (Event event : items) {
        DateTime start = event.getStart().getDateTime();
        if (start == null) {
          start = event.getStart().getDate();
        }
        System.out.printf("%s (%s)\n", event.getSummary(), start);
      }
    }
  } catch (IOException e) {
    e.printStackTrace(); // 建议不要忽略异常，便于排查问题
  }
}

方式二：使用无参list方法，再通过setCalendarId设置

Events events = calendar.events()
        .list()
        .setCalendarId("primary")
        .setMaxResults(5)
        .setTimeMin(now)
        .setOrderBy("startTime")
        .setSingleEvents(true)
        .execute();

步骤2：确认权限配置 #

1. 打开Google日历，进入「设置和共享」→「共享特定日历」
2. 找到服务账号的IAM邮箱，确认其权限为「查看所有事件」或更高（如「更改和管理事件」）
3. 若权限不足，重新调整并保存

步骤3：验证服务账号模拟逻辑 #

确认配置类中createDelegated("***@***.com")指定的邮箱是你共享日历的目标用户，且服务账号密钥文件路径正确无误。

额外建议 #

• 不要忽略IOException，添加异常打印逻辑，便于排查API调用中的错误（如权限不足、ID错误等）
• 可先调用calendar.calendars().get("primary").execute()验证是否能获取主日历信息，若能获取则说明primaryID有效，再查询事件

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