关于Google Calendar API FreeBusy请求无法正确显示全天事件的问题

我来帮你拆解下这个问题的核心原因和解决办法：

核心问题：全天事件的时间范围与请求的timeMin/timeMax不匹配 #

Google Calendar里的全天事件在API中默认以date类型存储（而非带时分秒的dateTime），它的时间逻辑是覆盖目标日期的全天（本地时区），但转换为UTC时间后，可能会超出你当前设置的查询时间范围。

看你提供的请求参数：

• timeMin: 2018-04-23T05:00:00.000Z
• timeMax: 2018-04-24T06:00:00.000Z

假设你在UTC+8时区，本地的2018-04-23全天事件，转换为UTC后是2018-04-22T16:00:00Z到2018-04-23T16:00:00Z——这个区间和你的查询范围只有部分重叠，导致FreeBusy请求没能正确识别并返回它。

具体解决方案 #

1. 扩展查询时间范围以覆盖全天事件的UTC区间 #

把timeMin和timeMax调整为覆盖目标日期的完整UTC全天，比如：

{
  "timeMin": "2018-04-23T00:00:00.000Z",
  "timeMax": "2018-04-24T00:00:00.000Z",
  "items": [{"id": "<MYEMAILADDRESS>"}]
}

这样无论你的本地时区是什么，全天事件对应的UTC范围都会被完全覆盖，就能被FreeBusy请求识别到。

2. 确认全天事件的API存储格式 #

先通过Events.list接口获取该全天事件的详情，检查start和end字段：

• 如果是date类型（比如{"start": {"date": "2018-04-23"}}），说明是标准跨时区全天事件，按上面的方法调整查询范围即可。
• 如果是dateTime类型，说明你创建事件时没设置为全天模式，需要调整事件的创建参数，或者确保查询范围覆盖它的具体时分秒区间。

3. 清理请求中的无效日历ID #

你的返回结果里有个null日历的错误：

"null":{"busy":[],"errors":[{"domain":"global","reason":"notFound"}]}

这说明你的请求里包含了无效的日历ID（比如null），建议移除这类无效ID，避免干扰正常结果的返回。

验证效果 #

调整参数后重新发起请求，全天事件应该会出现在busy列表中，格式类似：

{"end":"2018-04-24T00:00:00.000Z","start":"2018-04-23T00:00:00.000Z"}

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