Golang应用通过服务账号认证读取Google日历事件为空问题

你当前代码返回空事件列表的核心原因是：Events.List("primary")接口访问的是服务账号自身的独立主日历，而非你个人Google账号下共享给服务账号的目标日历。服务账号是Google生成的独立虚拟身份，它自己的默认主日历没有任何你创建的事件，自然会返回空结果。

• 替换primary为目标日历的真实ID
  打开个人账号的Google Calendar网页端，在左侧「我的日历」栏找到需要读取的目标日历，点击日历旁的更多按钮（三个点图标）→选择「设置和共享」，下拉到「集成日历」板块，复制「日历ID」字段的值：个人主日历的ID一般就是你的Gmail邮箱地址，自定义创建的日历ID通常为随机字符串@group.calendar.google.com格式。将代码中Events.List的参数从"primary"替换为这个复制到的日历ID。
• 校验日历共享权限配置
  确认你之前添加服务账号邮箱为共享用户时，权限等级选择的是查看所有事件详情，如果选了「仅查看空闲/忙碌信息（隐藏活动详情）」，服务账号无法读取事件内容，会直接返回空列表。添加完共享用户后必须点击设置页底部的保存按钮，否则共享配置不会生效。
  注意：你不需要配置域范围委托（Domain-Wide Delegation），该功能仅面向G Workspace用户开放，个人Google账号通过共享授权即可满足访问需求，不用在这一步浪费时间。
• 修正时间参数的时区偏差问题
  你当前使用time.Now().Format(time.RFC3339)生成TimeMin参数，会默认带上开发机本地的时区偏移，如果本地时区和日历设置的时区不一致，可能导致未来的事件被判定为早于当前时间从而被API过滤。稳妥写法是将当前时间转为UTC时区后再格式化，同时补充参数过滤无效事件，参考代码：

// 替换为你复制的真实日历ID
const targetCalendarID = "你的日历ID"
calEvents, err := googleCalendar.Events.List(targetCalendarID).
    TimeMin(time.Now().UTC().Format(time.RFC3339)).
    MaxResults(5).
    ShowDeleted(false). // 过滤已删除的事件
    SingleEvents(true). // 展开重复事件为单个条目，避免返回重复事件主条目导致的空内容
    Do()
if err != nil {
    app.errorLog.Println(err)
}

• 权限范围校验
  如果你初始化服务的时候没有显式指定权限范围，默认会使用高权限范围，一般不会有问题；如果显式指定过范围，需要确认包含日历只读权限即可，不需要申请编辑类高权限。

如果完成以上配置后依然返回空列表，可以在调用接口后打印完整的响应元信息，检查HTTP状态码和提示信息：当日历ID错误、共享权限未生效时，Google Calendar API不会直接抛出硬错误，大概率会返回空的事件列表，通过响应元信息可以快速定位是权限问题还是参数问题。
部署到Linode时只要保证googleAuth.json密钥文件的路径和代码中配置的路径一致、服务器可以正常连通Google Calendar API端点即可，不需要额外调整认证逻辑。

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