调用Google Calendar API更新事件时出现403 Forbidden错误求助

问题详情 #

调用Google Calendar API更新事件时持续返回403 Forbidden错误，官方错误文档未找到对应说明。已知信息：

• 授权账号为超级管理员
• 授权范围已配置https://www.googleapis.com/auth/calendar
• 只读API请求（如获取事件列表）可正常执行

错误响应：

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "forbidden",
    "message": "Forbidden"
   }
  ],
  "code": 403,
  "message": "Forbidden"
 }
}

请求代码：

let data = {
    'start': {
        dateTime: event_data.start.dateTime // 格式符合RFC3339，数据验证正确
    },
    'end': {
        'dateTime': new Date().toISOString()
    } 
};

return new Promise((resolve, reject) => {

    xhr.onreadystatechange = (e) => {
      if (xhr.readyState !== 4) {
        return;
      }

      if (xhr.status === 200) {
        resolve(JSON.parse(xhr.responseText));
      } else {
        console.warn('request_error');
      }
    };

    xhr.open('PUT', 'https://www.googleapis.com/calendar/v3/calendars/'+calendar_id+'/events/'+event_id);
    xhr.setRequestHeader('Authorization', 'Bearer ' + access_token);
    xhr.send(JSON.stringify(data));
});

排查与解决步骤 #

1. 检查目标日历的共享权限 #

超级管理员身份不代表默认拥有所有日历的编辑权限：

• 打开目标日历的共享设置，确认当前账号被授予「更改和管理事件」权限
• 若为用户个人日历，需确保当前账号是日历所有者，或已被明确赋予编辑权限

2. 验证授权令牌的实际权限 #

声明的权限范围可能未正确生效到令牌中：

• 重新生成授权令牌：旧令牌可能未包含读写权限，重新完成OAuth授权流程获取新的access_token测试
• 检查令牌权限：通过令牌信息接口验证令牌实际包含的权限，确认存在日历读写权限

3. 调整请求方法与字段完整性 #

PUT方法要求覆盖整个事件资源，字段缺失可能触发权限拦截：

• 补充核心字段：在请求数据中添加summary等必填字段（如'summary': event_data.summary），避免因资源不完整被拒绝
• 改用PATCH方法：PATCH支持部分更新，比PUT更适配局部修改场景，将请求方法改为PATCH后测试

4. 检查Admin Console的API权限限制 #

组织的Admin Console可能限制了超级管理员的API操作权限：

• 进入Admin Console的API权限设置页面，确认Calendar API的「编辑」权限未被禁用
• 检查组织的API访问策略，确保没有针对该账号或Calendar API的访问限制规则

5. 确认事件本身的可编辑状态 #

部分系统生成的事件可能被锁定：

• 尝试手动修改该事件，若手动也无法编辑，说明事件受保护（如会议资源自动创建的事件），需调整事件来源或联系管理员解锁

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