Google Apps Script向Classroom推送个性化材料报错排查

错误核心原因排查 #

• 硬编码错误课程ID：你代码里写的是字符串"Course ID"，这是无效值。Classroom的课程ID是一串纯数字（比如123456789012），必须替换为对应课程的实际ID，否则API找不到目标课程，直接返回实体不存在。
• 权限验证：虽然已添加Classroom API，需确认两点：
  • 运行脚本的账号必须是目标Classroom课程的教师/管理员，学生账号无调用courses.students.list的权限
  • 在脚本编辑器的「资源」>「高级Google服务」中，Classroom API处于启用状态
• 姓名匹配潜在问题：后续可能出现fullName精确匹配失败的情况（比如大小写差异、昵称/中间名不一致），建议提前导出Classroom学生姓名到Sheet，用统一格式匹配。

修正后的代码示例 #

1. 容错版获取学生ID函数 #

function getStudentId(studentName, courseId) {
  var response = Classroom.Courses.Students.list(courseId);
  var students = response.students || []; // 避免课程无学生时报错
  
  for (var i = 0; i < students.length; i++) {
    var studentFullName = students[i].profile.name.fullName;
    // 忽略大小写匹配，增强容错性
    if (studentFullName.toLowerCase() === studentName.toLowerCase()) {
      return students[i].userId;
    }
  }
  console.log(`未找到匹配学生：${studentName}`);
  return null;
}

2. 创建专属学生材料的主函数 #

function createStudentMaterials() {
  var courseId = "123456789012"; // 替换为你的实际课程ID
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var data = sheet.getDataRange().getValues();
  
  // 跳过表头（假设第一行为表头）
  for (var row = 1; row < data.length; row++) {
    var pupil = data[row][0]; // 假设第一列是学生姓名
    var studentId = getStudentId(pupil, courseId);
    
    if (!studentId) continue; // 找不到学生ID则跳过
    
    // 自定义材料内容，根据需求修改
    var materials = {
      title: `${pupil}的专属学习材料`,
      materials: [
        {
          link: {
            url: "https://example.com/your-material-link" // 替换为实际材料链接
          }
        }
      ]
    };
    
    // 调用API创建专属材料
    Classroom.Courses.CourseWorkMaterials.create(
      materials, 
      courseId, 
      {
        assigneeMode: "INDIVIDUAL_STUDENTS",
        individualStudentsOptions: {studentIds: [studentId]}
      }
    );
  }
}

验证步骤 #

1. 打开目标Classroom课程，浏览器地址栏中class.google.com/c/<课程ID>/...里的数字串就是课程ID
2. 在脚本编辑器中，通过「资源」>「高级Google服务」确认Classroom API已启用
3. 首次运行脚本时，用课程教师账号完成授权
4. 可单独调用getStudentId函数，传入已知学生姓名和正确课程ID，测试是否能返回有效用户ID

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