Быстрый старт: проверьте посещаемость учащихся на курсах Google Meet

Выполните шаги на этой странице, чтобы создать надстройку Google Sheets, которая отслеживает посещаемость курсов Google Classroom, проводимых с помощью конференц-связи Google Meet. На следующем изображении показан курс с записанной посещаемостью:

Настраивать

Выполните следующие действия, чтобы настроить это краткое руководство:

  1. Создайте новую таблицу Google .
  2. На новом листе выберите пункт меню « Расширения» > « Скрипт приложений ». Если появится экран приветствия, щелкните Пустой проект .
  3. Удалите код в редакторе скриптов.
  4. Нажмите на название проекта «Проект без названия» и переименуйте его в «Посещаемость».
  5. Щелкните Ресурсы > Расширенные службы Google .
  6. В появившемся диалоговом окне найдите и щелкните переключатель включения /выключения для API Google Classroom и API отчетов администратора .
  7. Щелкните стрелку вниз справа от имени файла Code.js.
  8. Выберите «Переименовать» .
  9. Переименуйте файл в «Посещаемость».
  10. Скопируйте и вставьте следующий код в редактор скриптов:
/* Menu Options */
function onOpen() {
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('Options')
      .addItem("Import Last 5 Courses", 'importCourses')
      .addItem('Check Attendance on Current Sheet', 'checkAll')
      .addToUi();
}

/*
  Description: Option for teachers to import their
  most 5 recently created courses
*/
function importCourses() {
  var optionalArgs = {
    teacherId: 'me',
    courseStates: 'ACTIVE'
  };
  var response = Classroom.Courses.list(optionalArgs);
  var courses = response.courses
  for (var i = 0; i < courses.length; i++) {
    var courseName = courses[i].name
    var courseId = courses[i].id
    insertCourse(courseName, courseId)
  }
}

/*
  Description: Create the Sheet for Course
  @param {String} courseName - Name of Course
  @param {String} courseId - Corresponding Classroom ID
*/
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(['Student Name', 'Email Address', 'Replace with Meet Code'])
    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)
  }

/*
  Description: Adds the course's students to the course sheet
  @param {String} courseId - Corresponding Classroom ID
*/
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 <= students.length; i++) {
    try {
      studentNames.push(students[i].profile.name.fullName)
      studentEmails.push(students[i].profile.emailAddress)
    } catch (err) {
       return { "studentNames":studentNames, "studentEmails":studentEmails }
   }
 }
}

/*
  Description: Retrieves the Meet code from the Course Sheet
  and uses helper function to check attendance
*/
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);
    }
  }
}

/*
  Description: Checks the Meet for attendance of the given student
  @param {String} meetCode - Raw Meet Code from Course Sheet
  @param {Integer} index - Index corresponding to the Student's row
  in the Course Sheet
*/
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 == null) {
        markAbsent(ss,i+2,index)
      }
      else {
        markPresent(ss,i+2,index)
      }
    } catch (err) {
        continue
     }
  }
}

/*
  Description: Strips any "-' Characters to match needed format
  for Reports API
  @param {String} meetCode - Raw Meet Code from Course Sheet
*/
function getCleanCode(meetCode) {
  try{
    return meetCode.replace("/-/g","")
  } catch (err) { return meetCode; }
}

/*
  Description: Marks the student as absent for their corresponding cell
  @param {Object} sheet - Course Sheet object
  @param {Integer} i - Index of Sheet cell column to be filled
  @param {Integer} j - Index of Sheet cell row to be filled
*/
function markAbsent(sheet, i, j) {
    var cell = sheet.getRange(i, j);
    cell.setValue("Absent");
}

/*
  Description: Marks the student as absent for their corresponding cell
  @param {Object} sheet - Course Sheet object
  @param {Integer} i - Index of Sheet cell column to be filled
  @param {Integer} j - Index of Sheet cell row to be filled
*/
function markPresent(sheet, i, j) {
    var cell = sheet.getRange(i, j);
    cell.setValue("Present");
}
  1. Выберите «Файл» > «Сохранить все» .

Попробуйте

Выполните следующие действия, чтобы попробовать это краткое руководство:

  1. Вернитесь к электронной таблице и перезагрузите страницу. В строке меню появится меню « Параметры ».
  2. Нажмите «Параметры» > «Импорт последних 5 курсов» . Появится диалоговое окно, указывающее, что скрипт требует авторизации.
  3. Нажмите Продолжить . Второе диалоговое окно запрашивает авторизацию для определенных сервисов Google. Щелкните Разрешить . Электронная таблица теперь содержит лист, представленный вкладкой внизу, для каждого из ваших последних 5 курсов. У каждого курса есть список участников курса в первом столбце и идентификаторы Google Meet ID в верхней строке.
  4. Нажмите на один из листов курса.
  5. Нажмите «Параметры» > «Проверить посещаемость на текущем листе» . Посещаемость вводится для идентификаторов Google Meet текущего курса.
  6. Повторите шаги 4 и 5 для четырех других классов.

Публиковать

Так как это пример надстройки, наш туториал заканчивается. Если бы вы разрабатывали настоящее дополнение, последним шагом была бы его публикация , чтобы другие люди могли найти и установить его.

Создайте приложение посещаемости на другом языке

Вы также можете создать приложение учета посещаемости или добавить функции учета посещаемости в существующее приложение для дистанционного обучения, используя наши REST API или соответствующие библиотеки.

API REST, используемые в этом кратком руководстве:

Имена методов в этом кратком руководстве такие же, как и в этих REST API. Например, AdminReports.Activities.list соответствует Activities.list в Google Reports API.

Учить больше

Чтобы продолжить изучение того, как расширить Google Sheets с помощью Apps Script, ознакомьтесь со следующими ресурсами: