Google Calendar API用q参数过滤事件无结果及获取最近更新事件问题

1. 过滤事件状态的正确语法 #

q参数是Google Calendar API提供的全文搜索参数，仅用来匹配事件标题、描述、地点等文本内容，不支持直接过滤status这类结构化字段，这也是你之前传入q= "status ='confirmed'"后返回空列表的原因。

过滤事件状态不需要使用q参数，接口本身提供了独立的status请求参数，直接传入该参数即可，正确的请求写法如下：

events = service.events().list(
    calendarId='primary',
    pageToken=page_token,
    updatedMin=day,
    status='confirmed' # 直接指定status参数过滤已确认的事件
).execute()

status参数支持的取值有三个：confirmed（已确认）、tentative（暂定）、cancelled（已取消），可以满足各类状态过滤需求。

2. 获取最近更新事件列表的其他方法 #

如果不想依赖接口层面的过滤，也可以在本地获取全部更新事件后自行过滤，两种实现方式可选：

• 方法1：判断事件状态，仅处理已确认事件

for event in events['items']:
    if event.get('status') == 'confirmed':
        print(event['summary'])

• 方法2：直接判断字段存在性，避免KeyError

for event in events['items']:
    if 'summary' in event:
        print(event['summary'])

两种本地过滤方案都可以解决已取消事件无summary字段导致的报错问题，同时保留全部更新事件的原始数据供其他逻辑使用。

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