Google Workspace App Script团队假期日历无法同步现有用户事件排查

1. 检查老用户的脚本授权状态 #

• 老用户可能曾拒绝脚本授权，或授权已过期。让老用户打开脚本编辑器，点击右上角「运行」按钮触发重新授权流程，确保勾选所有日历相关权限（读取个人日历、写入团队共享日历）。
• 可在脚本中添加代码打印授权状态，确认权限完整性：

function checkAuthorization() {
  const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
  console.log(authInfo.getAuthorizationStatus());
  console.log(authInfo.getScopes());
}

2. 核验老用户个人日历的共享权限细节 #

• 即使表面配置一致，老用户个人日历可能存在隐藏限制：
  • 进入老用户个人日历的「共享设置」，确认是否允许域内服务账户/脚本访问（脚本运行身份为Workspace管理员或指定服务账户）。
  • 排查是否存在针对特定应用的访问排除规则，比如限制了Apps Script的访问权限。

3. 排查事件过滤规则匹配问题 #

• 官方脚本通常按特定关键词（如「休假」「Vacation」）过滤事件，老用户的历史事件可能不符合规则：
  • 核对老用户日历内假期事件的标题、标签、描述，是否与脚本中定义的过滤条件匹配。
  • 临时移除脚本内的过滤逻辑，测试是否能同步老用户的任意事件，确认是否为规则匹配导致的问题。

4. 重置触发器与清除脚本缓存 #

• 老用户的触发器可能存在异常状态：
  • 进入脚本的「触发器」页面，删除老用户相关的触发器后重新创建。
  • 添加代码清除脚本级缓存，避免旧数据干扰：

function clearScriptCache() {
  CacheService.getScriptCache().removeAll();
}

• 查看脚本执行日志，筛选老用户相关记录，排查是否有「权限不足」「日历ID不存在」等报错。

5. 检查老用户Workspace账户状态 #

• 老用户账户可能存在域内限制：
  • 确认账户未被设置「应用限制」，禁止访问Apps Script或日历API。
  • 排查账户是否处于「暂停」「受限」状态，这类状态会导致API调用失败。

6. 测试单个老用户的同步流程 #

• 在脚本中添加单用户同步测试函数，定位具体问题：

function testSyncSingleUser(userId) {
  const userCalendarId = `${userId}@yourdomain.com`;
  const teamCalendarId = "team-vacations@yourdomain.com";
  // 复制原脚本的同步逻辑，针对单个用户执行
  syncVacationEvents(userCalendarId, teamCalendarId);
}

• 传入老用户邮箱运行函数，通过日志查看具体执行错误。

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