用于查明学生是否在 Google 课堂中迟交作业的 Google Apps 脚本

Question

对于我正在开发的 Google Apps 脚本，我需要过滤掉迟交的学生提交以降低他们的成绩。

来自 Google 的文档 here 和 here 我假设这是通过使用 Classroom.Courses.CourseWork.StudentSubmissions.list 获得的，但我不知道如何将 late 参数应用于出现的列表，例如只得到那些迟交作业的人。

function onlyLate(){
   var courseId = ID;
   var courseWorkId = ID;
   var la = {"late":"LATE_ONLY"};
   var lat = Classroom.Courses.CourseWork.StudentSubmissions.list(courseId, courseWorkId, la);
   Logger.log(lat);

   for (i = 0; i < lat.length; i++) {
      // lower grades here
   }
} 

Answer 1

根据API spec，您需要提供适当的Enum 值（不一定是String 值）。如果将可选参数传递给{late: 'LATE_ONLY'} 的list 不起作用，那么您将需要过滤输出（可能有几页长）。

注意：您可以尝试late: "true"，因为Python client library's Google Classroom documentation 表示该参数是所需延迟的字符串：

late：string，请求的延迟值。如果指定，则返回的学生提交受请求值的限制。如果未指定，则无论late 值如何，都将返回提交。

function getAllLateSubmissionsByFiltering_(courseId, assignmentId) {
  const options = {
    // late: "LATE_ONLY"
    // or perhaps
    // late: "true"
  };
  const results = [];

  // Collect all results, not just those from the first page.
  do {
    var search = Classroom.Courses.CourseWork.StudentSubmissions.list(courseId, assignmentId, options);
    options.pageToken = search.nextPageToken;
    if (search.studentSubmissions && search.studentSubmissions.length)
      Array.prototype.push.apply(results, search.studentSubmissions);
  } while(options.pageToken);

  // Return only the results that were actually submitted late.
  return results.filter(function (studentSub) {
    studentSub.late === true;
  });
}

参考资料：

• Array#filter