
本文介绍如何使用 Google Apps Script 准确获取 Google 表单的满分(所有可评分题型的分值总和)、每位学生的实际得分,并进一步计算其得分百分比,解决 getItemResponseId 和 getItemResponseById 无法调用等常见错误。
本文介绍如何使用 google apps script 准确获取 google 表单的满分(所有可评分题型的分值总和)、每位学生的实际得分,并进一步计算其得分百分比,解决 `getitemresponseid` 和 `getitemresponsebyid` 无法调用等常见错误。
在将 Google 表单用作在线考试时,教师常需统计每位学生的得分及整体表现。但原生表单界面不直接提供“总分”或“百分比”汇总功能,必须借助 Apps Script 实现自动化计算。关键难点在于:FormResponse 对象没有 getItemResponseId() 方法,Form 对象也没有 getItemResponseById() 方法——这正是提问者脚本报错或返回 undefined 的根本原因。
正确思路是:先遍历表单所有题目(form.getItems()),筛选出支持评分的题型(如选择题、量表题、填空题等),累加其预设分值(getPoints())得到满分;再对每位答卷人,调用 getGradableItemResponses() 获取其已评分项,用 getScore() 累加实得分数。
以下是经过验证的完整解决方案:
通过Media.io OpenAPI,使用您的API密钥调用Google Veo 3.1,将文本或图像生成电影级AI视频。
function calculateGrades() {
const form = FormApp.getActiveForm();
// 步骤1:计算表单满分(所有可评分题目的分值总和)
const maxScore = form.getItems().reduce((total, item) => {
// 映射题型到对应转换方法,仅处理支持评分的题型
const typeMap = {
"MULTIPLE_CHOICE": "asMultipleChoiceItem",
"CHECKBOX": "asCheckboxItem",
"SCALE": "asScaleItem",
"TEXT": "asTextItem",
"PARAGRAPH_TEXT": "asParagraphTextItem",
"DATE": "asDateItem",
"TIME": "asTimeItem",
"DATETIME": "asDateTimeItem",
"DURATION": "asDurationItem"
};
const typeName = item.getType().toString();
const method = typeMap[typeName];
if (method && typeof item[method] === 'function') {
try {
const points = item[method]().getPoints();
return total + (typeof points === 'number' ? points : 0);
} catch (e) {
// 若某题未设置分值(如新建题未配置评分),跳过
console.warn(`题型 ${typeName} 未配置分值,跳过计入总分`);
return total;
}
}
return total;
}, 0);
if (maxScore === 0) {
console.error("⚠️ 未检测到任何已设置分值的可评分题目,请检查表单中各题是否启用‘评分’并分配了分值。");
return;
}
// 步骤2:计算每位学生的得分百分比
const responses = form.getResponses();
const percentages = responses.map(response => {
const scoredItems = response.getGradableItemResponses();
const studentScore = scoredItems.reduce((sum, itemResp) => sum + itemResp.getScore(), 0);
return parseFloat((studentScore / maxScore * 100).toFixed(2)); // 保留两位小数
});
// 步骤3:输出结果(可扩展为写入 Sheets 或发送邮件)
console.log(`? 表单满分:${maxScore}`);
console.log(`? 各学生得分百分比:`, percentages);
if (percentages.length > 0) {
const classAverage = parseFloat((percentages.reduce((a, b) => a + b, 0) / percentages.length).toFixed(2));
console.log(`? 全班平均分:${classAverage}%`);
}
}
✅ 使用说明:
- 打开你的 Google 表单 → 点击右上角 「⋮」→「编辑脚本」(Script Editor);
- 将上述代码粘贴进脚本编辑器,保存(Ctrl+S);
- 点击运行按钮 ▶️(首次运行需授权),然后查看 「执行」→「执行日志」(Ctrl+Enter)获取结果。
⚠️ 重要注意事项:
- 务必提前为每道可评分题设置分值:在表单编辑页,点击题目右上角「⋮」→「启用评分」→ 输入「满分」(如 5 分)。未设置的题目 getPoints() 返回 0,将导致总分偏低;
- 该脚本自动忽略未启用评分的题目(如纯文本说明题),确保计算逻辑严谨;
- getGradableItemResponses() 仅返回已作答且系统能识别的评分项,避免空值异常;
- 如需导出结果,可轻松扩展:用 SpreadsheetApp.openById("xxx").getSheetByName("Scores").appendRow([name, score, percent]) 写入指定表格。
掌握此方法后,你不仅能实时获得每位学生的百分制成绩,还可快速分析班级整体表现,真正实现 Google 表单的考试自动化闭环。










