如何使用Java清除次要日历全部事件？Clear API异常咨询

没错，你的推测完全正确！Google Calendar的Clear API仅支持清除主日历（primary calendar）的事件，这就是为什么你在次要日历上调用它时会收到那个看似矛盾的错误提示——这个API从设计上就被限制为只能作用于主日历，当你传入次要日历的ID时，系统会判定这是一个无效请求，从而返回“Cannot clear primary calendar.”的错误（不得不说这个错误提示确实有点误导性）。

下面给你两种可行的方法来清除你创建的次要日历中的所有事件：

方法一：批量删除事件（推荐） #

这是最稳妥的方式，既能清空事件又能保留日历本身的配置：

• 第一步：调用Events: list接口获取目标次要日历的所有事件
  执行请求：GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events
  注意：如果日历中的事件数量较多，接口会分页返回，你需要处理nextPageToken来获取所有事件。
• 第二步：批量删除获取到的事件
  遍历每个事件的id，调用Events: delete接口删除单个事件：
  DELETE https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/{eventId}
  如果你想提高效率，可以使用Google API的批量请求（Batch Requests），把多个删除请求打包成一个HTTP调用发送，减少请求次数。

方法二：删除并重建日历（适合极端场景） #

如果这个次要日历本身没有需要保留的配置（比如颜色、描述等），你可以直接删除整个日历再重建：

• 调用Calendars: delete接口删除目标日历：DELETE https://www.googleapis.com/calendar/v3/calendars/{calendarId}
• 调用Calendars: insert接口重新创建一个相同配置的日历。
  不过这种方式会丢失日历的所有原有属性，所以只建议在不需要保留日历设置的情况下使用。

额外注意事项 #

• 确保你的OAuth 2.0授权令牌拥有足够的权限：需要https://www.googleapis.com/auth/calendar（全权限）或者https://www.googleapis.com/auth/calendar.events（仅事件操作权限）。
• 处理大量事件删除时，要注意Google API的调用频率限制，避免触发Rate Limit，必要时可以加入短时间的延迟分批处理。

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