Google Calendar API v3删除日历后是否有查询延迟？刚删日历无法查询

核心原因：API同步延迟 + 资源类型混淆 #

你遇到的半小时前删除的日历无法通过CalendarList: list查到，主要有两个关键原因：

• 同步延迟：Google Calendar后台与API接口的数据同步并非实时，刚删除的日历通常需要几分钟到几十分钟才能被标记到CalendarList的已删除条目里，而半年前删除的日历早已完成同步，因此能正常查询。
• CalendarList与日历资源的区别：CalendarList是你个人“我的日历”列表的条目集合，而实际的日历资源（包含所有事件数据）在被删除后会先进入回收站，此时可能还未同步到CalendarList的已删除结果中，但直接通过日历ID仍可访问。

解决步骤 #

1. 直接通过日历ID访问已删除日历 #

如果你记得日历ID（通常是类似xxx@group.calendar.google.com或xxx@gmail.com的格式，可从过往邮件邀请、旧导出文件或日历设置记录中查找），直接调用Calendars.get接口获取日历信息：

curl \
  'https://www.googleapis.com/calendar/v3/calendars/[你的日历ID]' \
  --header 'Authorization: Bearer [你的访问令牌]' \
  --header 'Accept: application/json'

只要日历在30天回收站保留期内，该接口会返回包含"deleted": true标记的日历数据。

2. 恢复日历 #

获取到日历ID后，调用CalendarList.insert接口将其重新添加到你的日历列表中，即可完成恢复：

curl \
  'https://www.googleapis.com/calendar/v3/users/me/calendarList' \
  --header 'Authorization: Bearer [你的访问令牌]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"id": "[你的日历ID]"}' \
  --compressed

也可以直接通过Google Calendar网页端的“设置和共享”→“已删除的日历”入口恢复，网页端的同步速度通常比API更快。

3. 导出日历事件 #

无论日历是否已恢复，只要能获取到日历ID，就可以调用Events.list接口导出所有事件（包括已删除的）：

curl \
  'https://www.googleapis.com/calendar/v3/calendars/[你的日历ID]/events?showDeleted=true&singleEvents=true&maxResults=2500' \
  --header 'Authorization: Bearer [你的访问令牌]' \
  --header 'Accept: application/json'

• showDeleted=true：返回已删除的事件
• singleEvents=true：展开重复事件为单个条目
• maxResults=2500：单次请求最大返回数量，若事件更多需分页获取

额外排查点 #

• 权限范围检查：确保你的访问令牌包含https://www.googleapis.com/auth/calendar读写权限，只读权限可能限制对已删除资源的访问。
• 工作区账户特殊情况：若使用谷歌工作区账户，需确认管理员是否设置了特殊的日历回收策略，必要时联系管理员协助恢复。

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