本文介绍如何使用 Google Apps Script 正确计算 Google 表单考试的满分（所有可评分题型的分值总和）及每位学生的得分百分比，解决因误用 getItemResponseId 和 getItemResponseById 导致脚本报错或结果异常的问题。
本文介绍如何使用 google apps script 正确计算 google 表单考试的满分（所有可评分题型的分值总和）及每位学生的得分百分比，解决因误用 `getitemresponseid` 和 `getitemresponsebyid` 导致脚本报错或结果异常的问题。
在将 Google 表单用作在线考试时，一个常见需求是：自动统计每位学生的得分，并换算为百分比（即「学生得分 ÷ 满分 × 100%」）。但许多开发者会误以为可通过 FormResponse.getItemResponseId() 或 Form.getItemResponseById() 获取题目最大分值——实际上，这两个方法并不存在（Google Apps Script API 中无此接口），这正是原脚本无法运行或返回错误结果的根本原因。
正确的方法是：从表单本身（Form 对象）出发，遍历所有题目项（Item），提取每道可评分题的预设分值（getPoints()）并累加，从而得到理论满分。随后，再对每位学生的作答响应（FormResponse）调用 getGradableItemResponses()，汇总其实际得分。
以下是经过验证、可直接运行的完整解决方案：
function calculateGrades() {
const form = FormApp.getActiveForm();
// ✅ 步骤1：计算表单满分（遍历所有题目，累加 getPoints()）
const itemObj = {
"DATE": "asDateItem",
"LIST": "asListItem",
"TEXT": "asTextItem",
"TIME": "asTimeItem",
"CHECKBOX": "asCheckboxItem",
"MULTIPLE_CHOICE": "asMultipleChoiceItem",
"PARAGRAPH_TEXT": "asParagraphTextItem",
"SCALE": "asScaleItem",
"DATETIME": "asDateTimeItem",
"DURATION": "asDurationItem"
};
const maxScore = form.getItems().reduce((total, item) => {
const typeStr = item.getType().toString();
const asMethod = itemObj[typeStr];
if (asMethod && typeof item[asMethod] === 'function') {
try {
total += item[asMethod]().getPoints() || 0;
} catch (e) {
// 忽略不支持 getPoints() 的题型（如标题、分节符等）
}
}
return total;
}, 0);
if (maxScore === 0) {
console.warn("⚠️ 未检测到任何可评分题目，请检查表单中是否已为选择题、量表题等设置了分值。");
return;
}
// ✅ 步骤2：计算每位学生的百分比得分
const responses = form.getResponses();
const percentages = responses.map(response => {
const score = response.getGradableItemResponses()
.reduce((sum, itemResp) => sum + itemResp.getScore(), 0);
return parseFloat((score / 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}%`);
}
}? 关键注意事项：
- ✅ 满分必须从 Form.getItems() 获取，而非从 FormResponse 反向推导；
- ✅ getPoints() 仅对可评分题型有效（如单选、多选、量表、填空等），需通过 asXXXItem() 类型转换后调用；
- ✅ 非评分题（如纯文本说明、分节符）无 getPoints() 方法，应使用 try/catch 安全处理；
- ✅ getGradableItemResponses() 自动过滤出该响应中所有已评分题目，无需手动判断 isGradable()；
- ⚠️ 运行前请确保已在表单编辑器中为每道题手动设置分值（点击题目右上角 ⋯ → “设置分数”）。
将上述代码粘贴至 Google 表单的「脚本编辑器」（Extensions → Apps Script），保存后点击 ▶ 运行 calculateGrades，即可在右侧「执行日志」（View → Logs）中查看满分、每位学生百分比及班级平均分。如需导出结果，可进一步将 percentages 数组写入关联的 Google Sheet。
