使用Google服务账户调用Calendar API无法获取共享日历问题排查

核心问题拆解 #

• 服务账户的primary日历本身就是其自身邮箱对应的独立日历，这是正常行为——服务账户作为独立身份，不会自动关联你的个人主日历。
• calendarList.list()返回的是服务账户主动添加到自己日历列表中的日历，而非所有它有权限访问的日历。你共享给服务账户的个人日历，默认不会出现在它的CalendarList里。
• 调用calendars.get()时，只能使用日历ID（个人邮箱地址或系统分配的唯一日历ID），不能用日历的显示名称，这就是你传入名称返回404的原因。

具体解决步骤 #

1. 直接访问共享的个人日历
   若要访问你共享给服务账户的个人日历，需在calendars.get()中传入你的个人邮箱地址或目标日历的唯一ID，而非"primary"：

   // 用个人邮箱作为日历ID访问个人主日历
   com.google.api.services.calendar.model.Calendar calendar = calendarService.calendars().get("mypersonalemailaddress@gmail.com").execute();
   

2. 将共享日历添加到服务账户的CalendarList
   若要让共享日历出现在calendarList.list()的结果中，需要主动调用calendarList.insert()将其添加到服务账户的日历列表：

   // 创建CalendarList条目，传入目标日历ID
   CalendarListEntry calendarListEntry = new CalendarListEntry();
   calendarListEntry.setId("mypersonalemailaddress@gmail.com"); // 替换为你的个人邮箱或目标日历ID
   
   // 执行添加操作
   calendarService.calendarList().insert(calendarListEntry).execute();
   
   // 再次调用list即可获取到该日历
   CalendarList calendarList = calendarService.calendarList().list().execute();
   

3. 关键注意事项

   • 服务账户的primary日历是其自身的默认日历，无法替换为你的个人日历，这是Google服务账户的设计逻辑。
   • 若要获取日历的唯一ID，可在Google日历网页版的「设置和共享」-「日历设置」中找到「日历ID」字段。

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