Google Sheet操作前强制捕获用户名？脚本getUi报错求助

问题背景 #

• 4人（含本人）使用Google Sheet进行数据录入，表格数据来自gMaps API，需手动填写工作人员姓名列和更新时间戳列，希望实现用户名录入自动化
• 核心需求：通过无关闭/取消入口的模态对话框展示单选按钮（默认选中一个选项），用户选择姓名提交后存入全局可用变量，未完成选择前无法操作表格内容

当前报错及原因 #

执行自定义菜单触发的showDialog函数时，出现错误：Exception: Cannot call SpreadsheetApp.getUi() from this context，核心问题：

1. showModalDialog是异步方法，原代码中试图直接接收操作结果的逻辑错误
2. 全局变量userName在Google Apps Script会话中无法持久化，需改用专用存储服务
3. HTML对话框缺少表单提交逻辑，未正确触发后端函数完成用户名存储

修复后的完整代码 #

Code.gs #

/**
 * @OnlyCurrentDoc
 */

// 使用用户属性存储用户名，替代全局变量实现持久化
function getUserName() {
  return PropertiesService.getUserProperties().getProperty('userName');
}

function setUserName(name) {
  PropertiesService.getUserProperties().setProperty('userName', name);
}

function onOpen() {
  Logger.log("Code.gs: onOpen() called");
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('自定义菜单')
    .addItem('确认用户名', 'showDialog')
    .addToUi();
  Logger.log("Code.gs: 自定义菜单创建完成");

  // 打开表格时自动弹出对话框（按需启用）
  // showDialog();
}

function showDialog() {
  Logger.log("Code.gs: showDialog() called");
  const html = HtmlService.createTemplateFromFile('index');
  html.currentUserName = getUserName();
  const dialog = html.evaluate()
    .setWidth(400)
    .setHeight(300);
  SpreadsheetApp.getUi().showModalDialog(dialog, '请选择你的姓名');
}

function handleFormSubmit(form) {
  Logger.log("Code.gs: handleFormSubmit() called");
  const name = form.userName;
  setUserName(name);
  Logger.log("Code.gs: 已存储用户名: " + name);
  return {success: true};
}

index.html #

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <style>
      /* 隐藏对话框右上角关闭按钮，强制用户必须提交 */
      .goog-close-button { display: none !important; }
      .container { padding: 20px; font-family: Arial, sans-serif; }
      .radio-group { margin: 20px 0; }
      .radio-item { margin: 10px 0; font-size: 16px; }
      .submit-btn { padding: 8px 16px; background: #4285F4; color: white; border: none; border-radius: 4px; cursor: pointer; }
    </style>
  </head>
  <body>
    <div class="container">
      <h2>请选择你的姓名</h2>
      <form id="nameForm">
        <div class="radio-group">
          <div class="radio-item">
            <input type="radio" name="userName" value="Dennis" <?= currentUserName === 'Dennis' ? 'checked' : '' ?>> Dennis
          </div>
          <div class="radio-item">
            <input type="radio" name="userName" value="Helen" <?= currentUserName === 'Helen' ? 'checked' : '' ?>> Helen
          </div>
          <div class="radio-item">
            <input type="radio" name="userName" value="Other" <?= currentUserName === 'Other' || !currentUserName ? 'checked' : '' ?>> Other
          </div>
        </div>
        <button type="submit" class="submit-btn">确认提交</button>
      </form>
    </div>
    <script>
      document.getElementById('nameForm').addEventListener('submit', function(e) {
        e.preventDefault();
        const formData = new FormData(this);
        const userName = formData.get('userName');
        // 调用后端函数存储用户名，成功后关闭对话框
        google.script.run
          .withSuccessHandler(() => google.script.host.close())
          .handleFormSubmit({userName: userName});
      });
    </script>
  </body>
</html>

关键修复点说明 #

1. 上下文报错解决：移除原代码中showModalDialog后的错误返回值接收逻辑，确保getUi()在自定义菜单触发的合法用户交互上下文调用
2. 持久化存储：用PropertiesService.getUserProperties()存储用户名，替代全局变量，确保同一会话或下次打开表格时仍能读取
3. 强制交互限制：通过CSS隐藏对话框关闭按钮，模态对话框默认阻止用户操作表格，强制用户必须选择并提交才能继续
4. 表单交互逻辑：添加提交按钮和JS事件监听，通过google.script.run完成前后端交互，提交成功后自动关闭对话框
5. 默认选中优化：根据已存储的用户名自动选中对应单选按钮，提升重复使用体验

使用说明 #

1. 将上述代码分别替换到Google Sheet的脚本编辑器中（Code.gs和index.html）
2. 保存脚本后刷新表格，在顶部菜单中找到「自定义菜单」→「确认用户名」触发对话框
3. 若需要打开表格时自动弹出对话框，取消onOpen函数中showDialog()的注释
4. 单元格中可通过自定义函数读取用户名：

   function GET_USER_NAME() {
     return getUserName();
   }
   

   在单元格输入=GET_USER_NAME()即可自动填充当前用户姓名

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