如何在Google Script Apps中按ID为Google Spreadsheet指定列赋值

场景说明 #

需要通过Apps Script的GET请求能力，传参类似id=1&rate=good，匹配Sheet里对应id的已有行，给空的rate列写入指定值，不新增行、不改动其他数据。
初始Sheet表结构（表名list_film）：

+----+-------+------+
| id | name  | rate |  
+----+-------+------+
| 1  | Item1 |      |
+----+-------+------+
| 2  | Item2 |      |
+----+-------+------+
| 3  | Item3 |      |
+----+-------+------+

预期更新后的效果（以传入id=1&rate=good为例）：

+----+-------+------+
| id | name  | rate |  
+----+-------+------+
| 1  | Item1 | good |
+----+-------+------+
| 2  | Item2 |      |
+----+-------+------+
| 3  | Item3 |      |
+----+-------+------+

原有代码的核心问题 #

• 误将筛选后的二维值数组当成Sheet行对象调用appendRow：appendRow是Sheet对象的方法，作用是在表格最末尾新增一整行，完全和“匹配已有行更新值”的需求不符
• 没有定位到匹配ID对应的实际Sheet行号，没法精准定位rate列的单元格位置
• 没有做匹配结果的异常兜底，找不到对应ID时没有明确反馈

修正后的可运行代码 #

function doGet(e) {
  // 读取请求参数，空值做兜底处理
  const id = e.parameter.id?.trim() || "1";
  const rate = e.parameter.rate?.trim() || "";
  // 绑定目标表格与工作表
  const ss = SpreadsheetApp.openByUrl("https://docs.google.com/spreadsheets/d/10S8Igzt1tpqUBgJHVKpny-2s6G3Y3-vFsLMvlZVqpkc/edit#gid=810612111");
  const sheet = ss.getSheetByName("list_film");
  return updateRateById(sheet, id, rate);
}

function updateRateById(sheet, targetId, targetRate) {
  // 读取表格所有带值的区域数据
  const allRowValues = sheet.getDataRange().getDisplayValues();
  // 跳过表头行，遍历所有数据行
  for (let index = 1; index < allRowValues.length; index++) {
    const rowId = allRowValues[index][0]; // A列存储id值
    // 匹配目标ID
    if (rowId === targetId) {
      // 计算实际行号：数组索引从0开始，Sheet行号从1开始
      const realRowNum = index + 1;
      // 定位C列（rate列）的对应单元格并写入值
      sheet.getRange(realRowNum, 3).setValue(targetRate);
      return ContentService.createTextOutput(`更新成功：ID=${targetId}，rate=${targetRate}`)
        .setMimeType(ContentService.MimeType.TEXT);
    }
  }
  // 未匹配到对应ID时的反馈
  return ContentService.createTextOutput(`更新失败：未找到ID为${targetId}的行`)
    .setMimeType(ContentService.MimeType.TEXT);
}

落地注意事项 #

• 部署Apps Script Web应用时，需将访问权限设置为「任何人」，否则外部请求无法正常触发脚本
• 代码默认列顺序为A列=id、B列=name、C列=rate，若实际表的列位置有调整，需同步修改代码中的列索引参数
• 写入操作执行后会直接覆盖对应单元格的原有值，若需要“追加而非覆盖”的逻辑，可先读取原有值再拼接新值写入

内容的提问来源于stack exchange，提问作者T6VK