使用API Key而非OAuth 2.0认证Google Calendar API的报错问题

首先明确核心逻辑：Google Calendar API的calendarList.list接口用于获取已认证用户的私有日历列表，这类关联用户私有数据的接口仅支持OAuth 2.0认证，API Key本身不绑定任何用户身份，无法用于访问私有用户资源，所以你调用时返回401属于正常权限校验结果，并非配置错误。
官方文档标注的接口支持API Key认证，是指API Key可用于访问公开无权限限制的日历资源，以下是API Key调用公开日历资源的Postman操作示例：

API Key调用公开日历Postman操作步骤 #

• 提前准备好目标公开日历的ID（格式通常为xxx@group.calendar.google.com，可在公开日历的设置页面获取）
• Postman新建GET请求，请求地址填写：https://www.googleapis.com/calendar/v3/calendars/[替换为实际公开日历ID]/events
• 切换到Auth标签页，认证类型选择API Key
  • Key字段填key
  • Value字段填你已经开通Calendar API权限的API密钥
  • Add to选项选择Query Params
• 直接点击发送，请求成功后会返回对应公开日历的事件列表JSON数据

注意：如果你的业务场景需要获取特定用户的日历列表、修改用户日历内容等操作，只能使用OAuth 2.0认证方式，无法用API Key替代。

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