通过HTML获取Spreadsheet ID：解决初始化报错与全局变量赋值求助

问题根源 #

Google Apps Script中，服务器端函数每次被google.script.run调用时，都会启动全新的执行上下文，全局变量无法跨请求保留。同时初始代码在脚本加载阶段就执行SpreadsheetApp.openById(id)，此时ID未赋值，直接导致报错。

解决思路 #

使用PropertiesService持久化存储用户输入的ID（支持脚本级或用户级存储），并在需要操作表格时再初始化，而非提前加载。

修改后的代码 #

Script.gs

// 存储用户输入的Spreadsheet ID到脚本属性（持久化保存）
function setSpreadsheetId(id) {
  PropertiesService.getScriptProperties().setProperty('SPREADSHEET_ID', id);
  
  // 验证ID有效性
  try {
    SpreadsheetApp.openById(id);
    return 'ID已保存且有效';
  } catch (e) {
    return '无效的Spreadsheet ID，请检查后重试';
  }
}

// 获取存储的ID并初始化表格
function getSpreadsheet() {
  var id = PropertiesService.getScriptProperties().getProperty('SPREADSHEET_ID');
  if (!id) throw new Error('请先输入有效的Spreadsheet ID');
  return SpreadsheetApp.openById(id);
}

// 示例后续操作：获取表格名称
function getSpreadsheetName() {
  var sheet = getSpreadsheet();
  return sheet.getName();
}

function doGet() {
  var template = HtmlService.createTemplateFromFile('HTML');
  // 页面加载时填充已保存的ID（如果存在）
  template.savedId = PropertiesService.getScriptProperties().getProperty('SPREADSHEET_ID') || '';
  return template.evaluate();
}

HTML

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
  </head>
  <body>
    <input id="KK" type="text" value="<?= savedId ?>" placeholder="输入Spreadsheet ID"/>
    <button onclick="passId()">保存ID</button>
    <div id="message"></div>

    <!-- 示例：调用后续表格操作 -->
    <button onclick="getSheetName()">获取表格名称</button>
    <div id="sheetName"></div>

    <script>
     function passId() {
       var id = document.getElementById("KK").value;
       google.script.run
         .withSuccessHandler(msg => document.getElementById("message").textContent = msg)
         .setSpreadsheetId(id);
     }

     function getSheetName() {
       google.script.run
         .withSuccessHandler(name => document.getElementById("sheetName").textContent = `表格名称：${name}`)
         .withFailureHandler(err => document.getElementById("sheetName").textContent = `错误：${err.message}`)
         .getSpreadsheetName();
     }
    </script>
  </body>
</html>

关键说明 #

• 持久化存储：PropertiesService会将ID保存到脚本属性中，即使关闭页面后再次打开也能保留
• ID验证：在保存ID时先验证有效性，避免后续操作出现无意义报错
• 统一初始化：所有需要操作表格的函数通过getSpreadsheet()获取实例，无需重复处理ID逻辑
• 错误处理：前端通过withSuccessHandler和withFailureHandler接收服务器端返回，提升交互体验

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