卡在 G Suite 开发人员快速入门中以“检查学生在 Google Meet 课程中的出勤率”

Question

我会非常感谢任何意见。 谢谢; 我正在使用 G Suite 开发人员快速入门获取 Meet 出勤脚本https://developers.google.com/gsuite/add-ons/editors/sheets/quickstart/attendance不幸的是，在使用提供的代码并进行了调整后，我总是为所有学生（无论他们是否在场）获得“缺席”或“在场”，这取决于我是否在应用程序名称“见面”的活动的 if 语句中使用“空”或“假”。 这是我作为超级用户使用的代码：

...

    function onOpen() {
      var ui = SpreadsheetApp.getUi();
  ui.createMenu('Opciones SG')
      .addItem("Importar Curso", 'importCourses')
      .addItem('Verificar Asistencia', 'checkAll')
      .addToUi();
} 

    function importCourses() {
  var optionalArgs = {
    teacherId: 'me',
    pageSize: 5
  };
  var response = Classroom.Courses.list();
  var courses = response.courses;
  for (var i = 0; i < 1; i++) {
    var courseName = courses[i].name;
    var courseId = courses[i].id;
    insertCourse(courseName, courseId)
  }
}

function insertCourse(courseName, courseId) {
    var spreadsheetName = courseName + "(" + courseId + ")"
    var activeSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
    var yourNewSheet = activeSpreadsheet.getSheetByName(spreadsheetName);

    if (yourNewSheet != null) {
        return
    }
    yourNewSheet = activeSpreadsheet.insertSheet();
    yourNewSheet.setName(spreadsheetName);
    yourNewSheet.appendRow(['Nombre', 'Email', 'Asistencia'])
    yourNewSheet.setFrozenRows(1)
    var studentNames = getRoster(courseId)["studentNames"]
    var studentEmails = getRoster(courseId)["studentEmails"]
    for (var i = 0; i < studentNames.length; i++) {
      yourNewSheet.appendRow([studentNames[i],studentEmails[i]])
    }
    yourNewSheet.autoResizeColumns(1, 2)
    yourNewSheet.setFrozenColumns(2)
  }

function getRoster(courseId) {
  var studentNames = []
  var studentEmails = []
  var optionalArgs = {
      pageSize: 100
  };
  var response = Classroom.Courses.Students.list(courseId, optionalArgs)
  var students = response.students

  for (var i = 0; i < 100; i++) {
    try {
      studentNames.push(students[i].profile.name.fullName)
      studentEmails.push(students[i].profile.emailAddress)
    } catch (err) {
       return { "studentNames":studentNames, "studentEmails":studentEmails }
   }
 }
}

function checkAll() {
  var ss = SpreadsheetApp.getActiveSheet();
  var sheet = ss.getDataRange().getValues();
  for (var i = 2; i < sheet.length * 100; i++){
    var meetCode = getCleanCode(sheet[0][i])
    // No Meet code given
    if (meetCode == null) {
      break;
    }
    else {
      // check whether each student was present in Meet
      checkMeet(meetCode, i+1);
    }
  }
}

function checkMeet(meetCode, index) {
  // universal settings - static
  var userKey = 'all';
  var applicationName = 'meet';
  var ss = SpreadsheetApp.getActiveSheet();
  var sheet = ss.getDataRange().getValues();
  for (var i = 0; i < sheet.length-1; i++) {
    var emailAddress = sheet[i+1][1]
    var optionalArgs = {
      event_name: "call_ended",
      filters: "identifier==" + emailAddress + ",meeting_code==" + meetCode
    };
    try {
      var response = AdminReports.Activities.list(userKey, applicationName, optionalArgs);
      var activities = response.items;
      if (activities == false) {
        markAbsent(ss,i+2,index)
      }
      else {
        markPresent(ss,i+2,index)
      }
    } catch (err) {
        continue
     }
  }
}

function getCleanCode(meetCode) {
  try{
    return meetCode.replace("/-/g","")
  } catch (err) { return meetCode; }
}

function markAbsent(sheet, i, j) {
    var cell = sheet.getRange(i, j);
    cell.setValue("Absent");
}

function markPresent(sheet, i, j) {
    var cell = sheet.getRange(i, j);
    cell.setValue("Present");
}

...

Answer 1

对于代码的正确功能，检查if (activities == null)或if (activities == undefined) - NOT if (activities == false)

• 如果没有响应项（即没有为给定的用户和会议代码找到任何项） - activities将是undefined ，但不是false 。
• if (activities == false)永远不会完成，如果你使用它 - 所有参与者都将被标记为存在
• 另一方面，如果由于其他原因activities == undefined - 例如因为您引入了错误的见面代码（不要忘记将'Asistencia'替换为有效的见面代码），所有参与者都将被标记为absent
• 请注意，报告 API 有一些延迟，因此不要指望实时检索参与数据。
• 如果所有参与者都被标记为absent - 可能数据尚未传播，请等待一段时间再试一次。
• 确保将正确的相遇代码传递给脚本。 您的见面代码应类似于xxx-xxxx-xxx 。
• 该脚本需要删除-以获得正确的功能。 为此，请在function getCleanCode(meetCode)中将return meetCode.replace("/-/g","")行更改为return meetCode.replace(/-/g, "");
• 至于您评论中的问题： 在这里您可以看到所有可用的Hangouts Meet Audit Activity Events ，可用于过滤而不是meeting_code 。 不幸的是，时间戳不是可能的查询参数之一。

Answer 2

这是我们已经使用了几个月的代码，没有故障：

    function onOpen() {
      var ui = SpreadsheetApp.getUi();
  ui.createMenu('Asistencia')
      .addItem('Asistencia', 'checkAll')
      .addItem('*Crear*', 'createNewSheets')
      .addToUi();
} 

function createNewSheets() {
  var ss        = SpreadsheetApp.getActiveSpreadsheet();

   // Get the range of cells that store employee data.
  var employeeDataRange = ss.getRangeByName("A:A");

  var employeeObjects = employeeDataRange.getValues();

  var template = ss.getSheetByName('Template');

  for (var i=0; i < employeeObjects.length; i++) {

     // Put the sheet you want to create in a variable
     var sheet = ss.getSheetByName(employeeObjects[i]);

      // Check if the sheet you want to create already exists. If so,
      // log this and loop back. If not, create the new sheet.
        if (sheet) {
           Logger.log("Sheet " + employeeObjects[i] + "already exists");
        } else {
           template.copyTo(ss).setName(employeeObjects[i]);
           }
        }
  return;
}



    function importCourses() {
  var optionalArgs = {
    teacherId: 'me',
    pageSize: 5
  };
  var response = Classroom.Courses.list(optionalArgs);
  var courses = response.courses;
  for (var i = 0; i < 2; i++) {
    var courseName = courses[i].name;
    var courseId = courses[i].id;
    insertCourse(courseName, courseId)
  }
}

function insertCourse(courseName, courseId) {
    var spreadsheetName = courseName + "(" + courseId + ")"
    var activeSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
    var yourNewSheet = activeSpreadsheet.getSheetByName(spreadsheetName);
  
    if (yourNewSheet != null) {
        return
    }
    yourNewSheet = activeSpreadsheet.insertSheet();
    yourNewSheet.setName(spreadsheetName);
    yourNewSheet.appendRow(['Nombre', 'Email', 'Asistencia'])
    yourNewSheet.setFrozenRows(1)
    var studentNames = getRoster(courseId)["studentNames"]
    var studentEmails = getRoster(courseId)["studentEmails"]
    for (var i = 0; i < studentNames.length; i++) {
      yourNewSheet.appendRow([studentNames[i],studentEmails[i]])
    }
    yourNewSheet.autoResizeColumns(1, 2)
    yourNewSheet.setFrozenColumns(2)
  }

function getRoster(courseId) {
  var studentNames = []
  var studentEmails = []
  var optionalArgs = {
      pageSize: 100
  };
  var response = Classroom.Courses.Students.list(courseId, optionalArgs)
  var students = response.students

  for (var i = 0; i < 100; i++) {
    try {
      studentNames.push(students[i].profile.name.fullName)
      studentEmails.push(students[i].profile.emailAddress)
    } catch (err) {
       return { "studentNames":studentNames, "studentEmails":studentEmails }
   }
 }
}

function checkAll() {
  var ss = SpreadsheetApp.getActiveSheet();
  var sheet = ss.getDataRange().getValues();
  for (var i = 2; i < sheet.length * 100; i++){
    var meetCode = getCleanCode(sheet[0][i])
    // No Meet code given
    if (meetCode == null) {
      break;
    }
    else {
      // check whether each student was present in Meet
      checkMeet(meetCode, i+1);

    }
  }
}

function checkMeet(meetCode, index) {
  // universal settings - static
  var userKey = 'all';
  var applicationName = 'meet';
  var ss = SpreadsheetApp.getActiveSheet();
  var sheet = ss.getDataRange().getValues();

//let today = new Date()
//var staringTime = new Date().toISOString();  
  
//  var DateValue = ss.getRange(1, 1).getValues();
  


  for (var i = 0; i < sheet.length-1; i++) {
    var emailAddress = sheet[i+1][1]
    var optionalArgs = {
      startTime: formatStartDate(),
      event_name: "call_ended",
      filters: "identifier==" + emailAddress + ",meeting_code==" + meetCode

    };
    try {
      var response = AdminReports.Activities.list(userKey, applicationName, optionalArgs);
      var activities = response.items;
      if (activities == undefined) {
        markAbsent(ss,i+2,index)
      }
      else {
        markPresent(ss,i+2,index)
      }
      } catch (err) {
        continue
    }

  }

}

function getCleanCode(meetCode) {
  try{
   return meetCode.replace(/-/g, "");
  } catch (err) { return meetCode; }
}

function markAbsent(sheet, i, j) {
    var cell = sheet.getRange(i, j);
    cell.setValue("A");
}

function markPresent(sheet, i, j) {
    var cell = sheet.getRange(i, j);
    cell.setValue("");
}

function formatStartDate(){
  let date = new Date();

  const offset = date.getTimezoneOffset();

  
  let offsetDate = new Date(date.getTime() - (offset*145*1000));
  return offsetDate.toISOString();
}