基于时间驱动触发器的Google Sheets脚本运行状态更新方案咨询

方案1：自定义侧边栏实时更新 #

时间驱动触发器属于无头执行环境，无法调用toast，但可以通过自定义侧边栏在表格网格旁的固定区域展示进度：

• 创建HTML侧边栏文件（命名为ProgressSidebar.html）：

<!DOCTYPE html>
<html>
  <body>
    <h3>脚本执行进度</h3>
    <div id="progressText">等待执行开始...</div>
    <script>
      // 每秒拉取一次最新进度
      setInterval(() => {
        google.script.run.withSuccessHandler(status => {
          document.getElementById('progressText').textContent = status;
        }).fetchCurrentProgress();
      }, 1000);
    </script>
  </body>
</html>

• 在GS脚本中添加核心逻辑：
  1. 初始化侧边栏（由表格按钮触发）：

  function launchProgressSidebar() {
    const html = HtmlService.createHtmlOutputFromFile('ProgressSidebar')
      .setTitle('执行进度');
    SpreadsheetApp.getUi().showSidebar(html);
    // 初始化进度存储
    PropertiesService.getScriptProperties().setProperty('executionProgress', '开始执行第1/5个脚本');
  }
  

  2. 进度读写函数：

  function fetchCurrentProgress() {
    return PropertiesService.getScriptProperties().getProperty('executionProgress') || '无进度信息';
  }
  
  function updateExecutionProgress(msg) {
    PropertiesService.getScriptProperties().setProperty('executionProgress', msg);
  }
  

  3. 在每个时间驱动函数中更新进度：

  function runScript2() {
    updateExecutionProgress('开始执行第2/5个脚本');
    // 你的业务代码
    // ...
    updateExecutionProgress('已完成第2/5个脚本，即将启动第3/5个脚本');
    // 创建下一个时间触发器的代码
  }
  

  用户点击按钮打开侧边栏后，就能实时看到进度更新，侧边栏位于表格网格右侧，不占用单元格空间。

方案2：结合状态栏同步显示 #

如果偏好更简洁的展示，可利用表格底部的状态栏，配合侧边栏的刷新逻辑同步进度：

• 在侧边栏的JS代码中添加状态栏同步：

google.script.run.withSuccessHandler(status => {
  document.getElementById('progressText').textContent = status;
  google.script.run.setSpreadsheetStatus(status);
}).fetchCurrentProgress();

• 新增GS函数设置状态栏：

function setSpreadsheetStatus(msg) {
  SpreadsheetApp.getActiveSpreadsheet().setStatus(msg);
}

状态栏会在表格网格底部上方显示进度信息，同样不占用单元格。

核心注意事项 #

• 必须用PropertiesService存储进度：时间驱动触发器和用户交互脚本属于不同执行上下文，无法直接共享变量，脚本属性是跨上下文传递状态的可靠方式。
• 可根据脚本执行时长调整刷新间隔：如果单步执行时间较长，可将侧边栏的刷新间隔改为2000ms或更久，减少不必要的服务调用。

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