如何在不删除或清空行的情况下更新Google表格

我需要一个函数来更新Google表格，要求更新某一行时，不会擦除该行中未被更新的原有值。

当前代码执行更新时，虽然能找到对应邮箱的行并更新，但未填写的列原有值会被清空，只保留新提交的更新内容。

//通过邮箱获取数据 - 用于找到对应邮箱所在行
function getDataByEmail1(email){
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var dataCells = sheet.getDataRange().getValues();
  var result = null;
  for(var i = 1; i < dataCells.length; i++){
    if(dataCells[i][0] == email){
      result = dataCells[i];
      break;
    }
  }
  return result;
}

// 此代码将通过上述getDataByEmail()函数检查mySheet，若邮箱存在则更新该记录；若不存在则执行else if语句创建新记录。

function updateRecord(email, password, id, sex, date) {
  var sheet = SpreadsheetApp.getActiveSpreadsheet();
  var mySheet = sheet.getSheetByName("sheet1");  
  var getLastRow = mySheet.getLastRow();
  var check = getDataByEmail(email);
  var table_values = mySheet.getRange(2, 1, getLastRow - 1, 8).getValues();
  for(i = 0; i < table_values.length; i++){
    if(table_values[i][0] == email) {
      mySheet.getRange(i+2, 1).setValue(email);
      mySheet.getRange(i+2, 2).setValue(password);
      mySheet.getRange(i+2, 3).setValue(id);
      mySheet.getRange(i+2, 4).setValue(sex);
      mySheet.getRange(i+2, 5).setValue(date);
 
      status = 'Record Updated';
    }    
    else if (check == null){ // 此else if语句可正常工作，会向表格提交新数据
      var sheet = SpreadsheetApp.getActiveSpreadsheet();
      var mySheet = sheet.getSheetByName("sheet1"); 
      var data = [[email,password,id,sex,date]];
      var row = mySheet.getLastRow() + 1;
      var cel = 1;
      var rowLength = data.length;
      var celLength = data[0].length;
      mySheet.getRange(row, cel, rowLength, celLength).setValues(data);

    status = 'New Record created';
    }      
  }
    return status;
} 


// 以下是我用于测试updateRecord()的函数

function updateRecordTest(){
  var data = updateRecord("user1@example.com", "pass1", "id1", "id1");
  Logger.log(JSON.stringify(data));
}

现有代码的问题在于：更新时直接用setValue覆盖对应列，哪怕传入参数为空或未传值，都会清空原有内容。要解决这个问题，核心是只更新传入有效值的列，未传入的列保留原有数据。

修改后的代码 #

// 通过邮箱获取目标行号
function getRowByEmail(email){
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var dataCells = sheet.getDataRange().getValues();
  for(var i = 1; i < dataCells.length; i++){
    if(dataCells[i][0] == email){
      return i + 1; // 返回表格实际行号（数组从0开始，表格行从1开始）
    }
  }
  return null; // 未找到匹配邮箱返回null
}

function updateRecord(email, password, id, sex, date) {
  var sheet = SpreadsheetApp.getActiveSpreadsheet();
  var mySheet = sheet.getSheetByName("sheet1");  
  var targetRow = getRowByEmail(email);

  if(targetRow) {
    // 获取该行原有全部数据
    var rowData = mySheet.getRange(targetRow, 1, 1, 8).getValues()[0];
    
    // 仅更新有传入有效值的列，无值则保留原有数据
    if(email !== undefined) rowData[0] = email;
    if(password !== undefined) rowData[1] = password;
    if(id !== undefined) rowData[2] = id;
    if(sex !== undefined) rowData[3] = sex;
    if(date !== undefined) rowData[4] = date;
    
    // 将更新后的整行数据写回表格
    mySheet.getRange(targetRow, 1, 1, rowData.length).setValues([rowData]);
    return 'Record Updated';
  } else {
    // 未找到匹配邮箱，创建新记录
    var data = [[email, password, id, sex, date]];
    var row = mySheet.getLastRow() + 1;
    mySheet.getRange(row, 1, data.length, data[0].length).setValues(data);
    return 'New Record created';
  }
}

// 测试函数示例：只更新密码和性别，其他列保留原值
function updateRecordTest(){
  var status = updateRecord("user1@example.com", "newPass123", undefined, "female");
  Logger.log(status);
}

关键修改点 #

1. 重写getRowByEmail函数，直接返回目标行号，简化后续操作
2. 更新前先获取该行原有数据，仅对传入有效参数的列进行替换，未传值的列保持原样
3. 移除原代码中冗余的循环和重复的表格对象获取逻辑，提升执行效率
4. 测试函数展示了部分字段更新的用法，验证原有数据不会被清空

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