本文详解如何通过 Google Apps Script 获取 Google 表单的总满分（即所有可评分题目的分值之和），并为每位考生计算得分百分比，解决 getItemResponseId 和 getItemResponseById 无效导致的常见错误。

本文详解如何通过 google apps script 获取 google 表单的总满分（即所有可评分题目的分值之和），并为每位考生计算得分百分比，解决 `getitemresponseid` 和 `getitemresponsebyid` 无效导致的常见错误。

在使用 Google 表单作为在线考试工具时，许多教师希望自动统计每位学生的得分及对应百分比。但官方 Apps Script API 并不支持直接获取“表单总分”，也不存在 getItemResponseId() 或 getItemResponseById() 这类方法——这些是常见误用，会导致脚本运行失败。正确做法是：遍历表单所有题目（form.getItems()），识别可评分题型，累加其预设分值（.getPoints()）作为满分；再对每位答卷调用 .getGradableItemResponses() 提取实际得分，最后计算百分比。

以下是经过验证、可直接部署的完整解决方案：

Andrew Google Calendar

Google Calendar API 快速入门：创建项目、启用 API、设置 OAuth 2.0 凭据。本指南将引导您完成下载凭据文件并将其用于访问 API 的全过程。

下载

function calculateGrades() {
  const form = FormApp.getActiveForm();

  // ✅ 步骤1：计算表单总满分（所有可评分题目的分值之和）
  const itemObj = {
    "CHECKBOX": "asCheckboxItem",
    "MULTIPLE_CHOICE": "asMultipleChoiceItem",
    "SCALE": "asScaleItem",
    "TEXT": "asTextItem",
    "PARAGRAPH_TEXT": "asParagraphTextItem",
    "DATE": "asDateItem",
    "TIME": "asTimeItem",
    "DATETIME": "asDateTimeItem",
    "DURATION": "asDurationItem",
    "LIST": "asListItem"
  };

  const maxScore = form.getItems().reduce((total, item) => {
    const typeStr = item.getType().toString();
    const method = itemObj[typeStr];
    if (method && typeof item[method] === 'function') {
      try {
        total += item[method]().getPoints() || 0;
      } catch (e) {
        // 跳过无法获取分值的题型（如未启用评分的文本题）
        console.warn(`Skipped item ${item.getTitle()} (${typeStr}):`, e.message);
      }
    }
    return total;
  }, 0);

  if (maxScore === 0) {
    console.error("⚠️  检测到满分=0，请确认至少有一道题已启用评分并设置了分值。");
    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}%`);
  }
}

⚠️ 关键注意事项：

• 必须手动为每道题启用评分：在表单编辑界面，点击题目右上角「⋮」→「启用评分」→ 设置分值（getPoints() 仅对已启用评分的题目返回有效值）。
• 不支持自动评分的题型（如纯文本、段落题）若未手动打分，则 getGradableItemResponses() 中不包含它们，也不会计入 maxScore。
• 脚本需在表单的脚本编辑器中运行：打开表单 → 右上角「⋮」→「编辑脚本」→ 粘贴代码 → 保存 → 点击 ▶️ 运行 calculateGrades。
• 权限提示：首次运行会请求授权（https://www.googleapis.com/auth/forms.currentonly），请按提示允许。

该方案结构清晰、容错性强，并已规避原始代码中的核心 API 错误。你可进一步将 percentages 数组写入关联的 Google Sheet，实现成绩自动归档与可视化分析。