使用GAS删除Google Classroom课程触发Precondition check failed报错如何解决

错误原因 #

• 最核心原因是Google Classroom API要求课程必须处于*归档（ARCHIVED）*状态才允许删除，直接删除状态为活跃（ACTIVE）的课程会触发前置校验失败的报错。
• 次要原因包括：当前操作账号没有该课程的删除权限（非课程所有者/域管理员）、输入的课程ID错误、对应课程已经被删除不存在。

解决方法 #

方案1：代码内先修改课程状态再删除 #

修改你的代码，在调用删除接口前先将目标课程状态更新为归档，参考代码如下：

function deleteOneCourse() {
  const idclasse = '383075820272';
  // 先更新课程状态为归档
  Classroom.Courses.patch({
    courseState: 'ARCHIVED'
  }, idclasse);
  // 执行删除操作
  Classroom.Courses.remove(idclasse);
}

方案2：手动归档后再执行删除代码 #

你也可以先打开Google Classroom网页端，找到目标课程，手动点击「三个点-归档」，确认归档完成后再运行你原来的删除代码即可。

额外校验项 #

如果操作后仍报错，请检查以下内容：

• 确认你的Apps Script项目已经添加了Google Classroom API服务：进入Apps Script项目页，点击左侧「服务」旁的+号，找到Google Classroom API完成添加。
• 确认当前登录的Google账号是该课程的创建者，若为企业Workspace账号，需联系域管理员确认你的账号拥有Classroom课程删除权限。
• 核对课程ID是否正确，可从课程网页的URL中提取确认。

内容的提问来源于stack exchange，提问作者carlos a matheus hung