Google Apps Script中refresh()函数无法加载最新数据的原因

问题根源 #

Google Slides会对嵌入的Sheets图表进行缓存，默认的refresh()方法有时无法强制绕过缓存拉取最新数据，导致刷新后仍显示旧内容。

解决方案1：先刷新源Sheets图表再同步Slides #

在刷新Slides中的嵌入图表前，先强制刷新源Sheets里的对应图表，确保数据源已更新，再同步到Slides：

var presentation = SlidesApp.getActivePresentation();
var slides = presentation.getSlides();

for (var x = 0; x < slides.length; x++) {
  var slide = slides[x];
  var sheetsCharts = slide.getSheetsCharts();

  for (var y = 0; y < sheetsCharts.length; y++) {
    var shChart = sheetsCharts[y];
    // 获取源表格和图表ID
    var sourceSpreadsheetId = shChart.getSpreadsheetId();
    var sourceChartId = shChart.getChartId();
    
    // 刷新源Sheets中的图表（强制重新计算数据）
    var sourceSpreadsheet = SpreadsheetApp.openById(sourceSpreadsheetId);
    var sourceCharts = sourceSpreadsheet.getCharts();
    for (var z = 0; z < sourceCharts.length; z++) {
      if (sourceCharts[z].getId() === sourceChartId) {
        sourceCharts[z].refresh();
        break;
      }
    }
    
    // 刷新Slides中的嵌入图表
    shChart.refresh();
  }
}
// 保存并关闭演示文稿，确保更改生效
presentation.saveAndClose();

解决方案2：删除旧图表后重新插入（彻底绕过缓存） #

如果第一种方法仍无效，直接删除旧图表并从Sheets重新插入，完全绕过Slides的缓存机制：

var presentation = SlidesApp.getActivePresentation();
var slides = presentation.getSlides();

for (var x = 0; x < slides.length; x++) {
  var slide = slides[x];
  var sheetsCharts = slide.getSheetsCharts();

  // 反向遍历避免删除元素后索引混乱
  for (var y = sheetsCharts.length - 1; y >= 0; y--) {
    var shChart = sheetsCharts[y];
    // 记录旧图表的位置和尺寸
    var left = shChart.getLeft();
    var top = shChart.getTop();
    var width = shChart.getWidth();
    var height = shChart.getHeight();
    // 获取源表格和图表ID
    var sourceId = shChart.getSpreadsheetId();
    var chartId = shChart.getChartId();
    
    // 删除旧图表
    shChart.remove();
    // 从源Sheets重新插入相同图表
    slide.insertSheetsChart(sourceId, chartId, left, top, width, height);
  }
}

额外注意事项 #

• 确保脚本拥有Google Slides和Google Sheets的访问权限，首次运行时需授权
• 若使用定时触发脚本，注意控制触发频率，避免超出Google API的调用限制
• 浏览器端查看时，若仍显示旧数据，可尝试刷新页面或切换到"幻灯片放映"视图再返回

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