Google Sheets Apps Script无法获取未确认单元格值求助

当用户编辑单元格后未按回车确认，编辑内容仅停留在客户端浏览器的编辑状态，并未同步到Google Sheets服务器，因此Apps Script服务器端代码获取的仍是旧值。之前切换活动单元格的方法无效，因为服务器端指令无法触发客户端的提交动作。

以下是两种有效解决方法：

方法一：客户端脚本触发值提交（推荐） #

通过弹出一个极小的模态窗口，在客户端执行单元格失焦操作，强制提交未确认的编辑内容，再执行数据发送逻辑：

// 按钮触发的主函数
function sendData() {
  const ui = SpreadsheetApp.getUi();
  // 创建极小弹窗执行客户端脚本
  const html = HtmlService.createHtmlOutput(`
    <script>
      // 让当前激活的单元格失去焦点，提交编辑值
      document.activeElement.blur();
      // 值提交后调用实际发送数据的函数并关闭弹窗
      google.script.run.withSuccessHandler(() => window.close()).finishSendData();
    </script>
  `).setHeight(0).setWidth(0);
  ui.showModalDialog(html, '');
}

// 实际执行数据发送的函数
function finishSendData() {
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("L1");
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("目标工作表名称");
  
  // 示例：获取L1工作表A1的值并写入目标工作表A1
  const latestValue = sourceSheet.getRange('A1').getValue();
  targetSheet.getRange('A1').setValue(latestValue);
  
  // 可选：提示操作完成
  SpreadsheetApp.getUi().alert('数据已成功发送');
}

原理说明 #

• document.activeElement.blur()：在客户端让当前处于编辑状态的单元格失去焦点，浏览器会自动将编辑内容提交到Google Sheets服务器。
• 弹窗尺寸设为0×0，用户几乎无感知，完成后自动关闭。

方法二：启用Sheets API（进阶） #

若不想使用弹窗，可启用Google Sheets API，通过API直接获取最新的单元格状态，但需要额外配置API权限，步骤如下：

1. 在Apps Script编辑器中，点击「资源」→「高级Google服务」，启用「Google Sheets API」。
2. 使用Sheets.Spreadsheets.get()方法获取包含未提交值的单元格数据（需指定includeGridData参数），但这种方法逻辑较复杂，适合有API使用经验的用户。

注意事项 #

• 方法一无需额外权限配置，实现简单，适合大多数场景。
• 确保按钮绑定的是sendData函数，而非finishSendData。

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