Google Calendar API返回非指定时间范围事件问题求助

我来帮你排查几个最可能的原因：

• 参数格式错误：字符串未加引号
  你写的timeMin: 2018-05-26T10:00:00-07:00和timeMax: 2018-06-03T10:00:00-07:00，如果是在代码（比如JavaScript、Python等）中作为参数传递，必须把时间戳用引号包裹成字符串。如果没有引号，解释器会把2018-05-26当成数值计算（结果是1987），后面的部分会导致语法错误或者被忽略，API实际收到的参数根本不是你期望的时间范围，自然会返回无关事件。正确写法应该是：

  // 示例：JavaScript中的正确格式
  timeMin: "2018-05-26T10:00:00-07:00",
  timeMax: "2018-06-03T10:00:00-07:00"
  

• 时区不匹配导致的时间转换误差
  Google Calendar API在处理timeMin和timeMax时，会将这些时间转换为事件所在的时区（或者你指定的查询时区）进行比较。虽然你举的例子中事件时间明显早于timeMin，但还是建议你尝试：

  1. 统一使用UTC时间（比如2018-05-26T17:00:00Z，因为-07:00加7小时就是UTC）作为参数，避免时区转换带来的偏差。
  2. 在请求中添加timeZone参数，指定你期望的查询时区（比如timeZone: "America/Los_Angeles"），让API统一按这个时区过滤事件。

• 重复事件的主事件干扰
  如果返回的旧事件是重复事件的主事件（即创建重复系列时的原始事件），API可能会返回整个系列的信息，即使部分实例不在你的时间范围内。这种情况下，你可以在请求中添加singleEvents: true参数，让API返回重复事件的每个具体实例，而不是主事件，这样就能准确过滤出在timeMin和timeMax内的内容。

• 参数传递错误
  检查你的请求是否正确传递了timeMin和timeMax参数，有没有拼写错误（比如写成timemin小写，或者time_Max），或者参数被其他代码覆盖了。可以通过打印请求的完整参数，或者查看API请求日志，确认实际发送给API的参数是否和你设置的一致。

你可以先检查第一个原因（给时间字符串加引号），这是最常见的低级错误，很多人手动写参数时容易忽略。如果还是不行，再依次排查后面的几点。

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