google-api - Google Calendar API v3：FreeBusy 请求返回“请求的时间范围太长”。

Question

谷歌日历的 freeBusy 方法似乎不会接受超过两个月左右的 timeMin/timeMax 范围。我应该如何找到从现在到永远（或未来的遥远点）的日历范围的忙/闲信息？

要求：

{
  "items": [
    {
      "id": "MY_GMAIL_CALENDAR_ID"
    }
  ],
  "timeMin": "2015-09-19T00:00:00-04:00", // today
  "timeMax": "2016-09-19T00:00:00-04:00" // 1 year from now
}

回复：

{
 "error": {
  "errors": [
   {
    "domain": "calendar",
    "reason": "timeRangeTooLong",
    "message": "The requested time range is too long.",
    "locationType": "parameter",
    "location": "timeMax"
   }
  ],
  "code": 400,
  "message": "The requested time range is too long."
 }
}

Answer 1

目前空闲繁忙查询的最大时间范围约为 3 个月，但该值可能会在没有警告的情况下更改。相反，最佳实践是使用合理的小范围（如一个月）并在需要获取较长时间段内的忙/闲信息时执行多个查询。