Google Calendar API events.list返回超指定时间范围事件问题

两个问题完全独立，不存在关联：

元组格式输出问题 #

和接口返回没有任何关系，是打印逻辑导致的：

• 接口返回的事件数据解析到Python后是标准字典结构，和文档描述完全一致，不存在返回额外字段、元组格式数据的情况
• 代码里写了print(event.items())，Python字典内置的.items()方法，返回的就是由(键, 值)二元组组成的视图对象，打印出来自然全是元组。直接写print(event)就能看到正常的字典结构。

返回超出时间范围事件问题 #

首先是代码里的低级笔误：

• 接收接口返回结果的变量写的是eevents，开头多打了一个e，后面遍历事件、取分页token的时候用的全是events变量。如果代码运行没报NameError，说明events是之前代码运行残留的旧变量，存的是没加时间过滤的历史请求结果，从头到尾遍历的就不是这次带时间参数请求回来的数据，拿到5月的事件属于正常情况。

如果修正变量名之后还是能看到时间范围外的事件，那是API的正常过滤逻辑：

• Calendar API的timeMin和timeMax参数，默认匹配所有和指定时间区间有重叠的事件，包含重复事件的主条目。哪怕一个重复事件的主条目起止时间是5月，只要它生成的某一个重复实例落在你指定的6月28日-7月1日区间内，这个主条目就会被返回，看起来就像是返回了时间外的数据。

• 先修正变量名笔误，保证接收返回值的变量和后续使用的变量名一致：

events = service.events().list(calendarId='primary', pageToken=page_token, timeMax = "2022-07-01T00:00:00Z",
                               timeMin = "2022-06-28T00:00:00Z").execute()

• 如果不需要重复事件主条目，希望接口直接把落在时间区间内的重复事件展开成单个实例返回，在请求参数里加上singleEvents=True：

events = service.events().list(
    calendarId='primary',
    pageToken=page_token,
    timeMax="2022-07-01T00:00:00Z",
    timeMin="2022-06-28T00:00:00Z",
    singleEvents=True
).execute()

• 打印调试的时候如果不想看到元组，把.items()去掉，直接打印event对象即可。

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