如何通过单次API调用获取单个谷歌账号下多个Google Calendar的所有事件

核心结论 #

Google Calendar 公开API目前没有提供原生单端点支持直接拉取同账号下所有日历的全部事件，不过你可以用官方提供的**批量请求（Batch Requests）**能力实现仅发起一次HTTP调用拿到所有日历的事件，完全避免循环发起多次HTTP请求的问题。

具体实现步骤 #

• 第一步先调用GET https://www.googleapis.com/calendar/v3/users/me/calendarList接口，拉取当前授权账号下所有可见日历的calendarId列表
• 第二步把每个日历对应的事件拉取请求（也就是你查到的/calendar/v3/calendars/{calendarId}/events接口请求），按照谷歌批量请求的格式封装到同一个HTTP请求体中，单批量请求最多支持100个子请求，完全覆盖你6个日历的使用场景
• 第三步发送封装好的批量请求，谷歌服务器会一次性返回所有子请求的响应结果，你只需解析一次HTTP响应就能拿到全部日历的事件数据

注意事项 #

• 批量请求仅减少多次HTTP请求的网络开销，配额消耗和单独发起每个事件拉取请求一致，每个子请求会计为1次配额消耗
• 如果你的应用需要定期同步事件，推荐搭配事件接口的syncToken参数做增量拉取，不用每次全量拉取所有事件，能大幅提升拉取效率
• 目前没有其他可以直接返回全日历事件的原生接口，批量请求是官方推荐的最优替代实现方案

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