Google Calendar API监听事件报401无效凭证，求解决方案

问题核心原因 #

API Key仅支持无需用户身份验证的只读公开数据请求（比如你用的events.list获取公开日历事件），但events.watch属于需要创建和管理订阅的操作——哪怕目标日历是公开的，也必须通过OAuth 2.0验证用户身份。API Key不具备身份关联能力，因此会返回401权限错误。

解决步骤 #

1. 切换到OAuth 2.0授权流程

先在Google Cloud控制台给你的项目配置OAuth客户端ID，然后修改客户端初始化逻辑，加入OAuth相关配置：

function initAuthClient() {
  gapi.load('client:auth2', () => {
    gapi.client.init({
      clientId: '<你的OAuth客户端ID>',
      discoveryDocs: <discoveryDocs>,
      scope: 'https://www.googleapis.com/auth/calendar.readonly' // 只读权限足够监听公开日历
    }).then(() => {
      const authInstance = gapi.auth2.getAuthInstance();
      // 未授权则发起登录授权
      if (!authInstance.isSignedIn.get()) {
        authInstance.signIn();
      }
    });
  });
}

// 页面加载时初始化授权客户端
document.addEventListener('DOMContentLoaded', initAuthClient);

2. 修正watchCalendar函数逻辑

基于OAuth授权后的上下文调用events.watch，同时注意webhook地址必须是公网可访问的HTTPS地址（不能用相对路径./app.html）：

function watchCalendar() {
  gapi.client.calendar.events.watch({
    "calendarId": <calendarId>,
    "resource": {
      "id": "unique-subscription-123", // 用随机唯一ID避免重复订阅
      "type": "web_hook",
      "address": "https://your-public-domain.com/calendar-webhook" // 公网HTTPS端点
    }
  }).then((response) => {
    // 订阅成功后，保存订阅ID和过期时间，后续可用于取消订阅
    console.log('订阅创建成功:', response.result);
  }).catch((reason) => {
    console.error('订阅失败:', reason);
  });
}

3. 额外注意事项

• Webhook地址必须满足：HTTPS协议、公网可访问、端口为443（默认）或Google允许的其他端口。
• 每次调用watch会生成新订阅，建议定期清理过期/无用订阅，避免资源浪费。
• 若监听他人的公开日历，授权用户只需拥有该日历的访问权限即可；若监听自己的日历，授权用户需是日历所有者。

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