在Google Apps Script中批量添加用户至Google日历遇acl.insert报错求助

错误原因拆解 #

你遇到的「未找到acl.insert API调用」错误，核心是三个问题导致的：

• 未启用Google Calendar高级服务：Apps Script默认不加载该服务，必须手动开启
• 参数逻辑错误：Calendar.Acl.insert的第二个参数应为目标日历ID而非用户邮箱；同时权限配置里的scope.value要填用户邮箱，不是日历ID
• 授权权限不足：脚本未获取到操作日历权限的授权

分步解决 #

1. 开启Google Calendar高级服务 #

在Apps Script编辑器内操作：

• 点击左侧菜单栏的「服务」
• 选择「添加服务」，找到「Calendar API」点击添加，版本选v3即可

2. 修正代码逻辑 #

调整参数顺序与权限配置，同时增加错误捕获避免单个用户添加失败导致批量操作中断：

function addMemberToCalendar() {
  const calendarId = '你的日历ID'; // 格式示例：xxx@group.calendar.google.com 或个人邮箱
  const subscribers = AdamMemberScripts.getMembers();

  // 筛选需要订阅的用户邮箱
  const subscribersArray = subscribers
    .filter(el => el.toggleCalendarSubscription)
    .map(el => el.email);

  // 批量添加用户
  subscribersArray.forEach(email => {
    const resource = {
      'scope': {
        'type': 'user',
        'value': email // 此处填写要添加的用户邮箱
      },
      'role': 'reader' // 可按需改为writer（可编辑）、owner（所有者）等权限
    };
    try {
      Calendar.Acl.insert(resource, calendarId); // 第二个参数为目标日历ID
      console.log(`成功添加用户：${email}`);
    } catch (e) {
      console.error(`添加${email}失败：${e.message}`);
    }
  });
}

3. 确认授权范围 #

若之前授权过但权限不足，可手动配置：

• 打开脚本编辑器的「项目设置」，勾选「显示"appsscript.json"清单文件」
• 在oauthScopes数组中添加：

  "https://www.googleapis.com/auth/calendar"
  

可用的批量添加API选项 #

作为日历所有者，可通过以下两种方式实现批量添加：

• Calendar API v3的Acl.insert方法：即上述使用的方式，通过Apps Script高级服务直接调用，适合中小规模用户批量添加
• 批量请求（Batch Requests）：若需添加的用户超过100个，用批量请求可减少API调用次数、提升效率，需构造批量请求的HTTP内容，在Apps Script里通过UrlFetchApp发送请求即可

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