如何将Google Sheet数据注入Google Slides？选追加列表还是直接函数？

方案优劣对比 #

方案2（直接按[标签页名]."{表头}"规则读取）更优、资源消耗更低，原因如下：

• 方案1需要预读取所有标签页的全量数据存入列表，标签页数量较多时会占用更多内存和Google Workspace服务配额，每次运行都要全量扫描所有标签页，新增标签页后也需要重新扫描才能生效
• 方案2是按需读取，仅当用到某个标签页的数据时才调用接口读取对应范围，不需要维护中间列表，配额消耗和内存占用都低得多，用户新增城市标签页后无需额外操作即可直接使用，扩展性更强

列表方案实现方法 #

你原代码存在两个明显问题：一是valList.append为错误语法，JavaScript数组添加元素应使用push方法；二是循环内直接return values，导致只读取第一个符合要求的标签页就终止运行，无法生成全量追加列表。
生成追加列表的函数示例：

var NARRATIVE_SHEETS_URL = '替换为你的Gsheet链接'
const IGNORE_TABS = ["Presentation", "Start", "End", "Raw Data"];
// 生成全量标签页数据列表
function getAllSheetDataList() {
  var ss = SpreadsheetApp.openByUrl(NARRATIVE_SHEETS_URL);
  var sheets = ss.getSheets();
  var dataList = [];
  for (var i = 0; i < sheets.length; i++) {
    var sheet = sheets[i];
    var sheetName = sheet.getSheetName();
    if (IGNORE_TABS.includes(sheetName)) continue;
    // 读取固定范围D3:D6的数据，对应aaa/bbb/ccc/ddd
    var values = sheet.getRange("D3:D6").getValues().flat();
    // 把标签页名和对应数据绑定存入列表
    dataList.push({
      sheetName: sheetName,
      aaa: values[0],
      bbb: values[1],
      ccc: values[2],
      ddd: values[3]
    })
  }
  return dataList;
}

这个函数返回的列表会包含所有非忽略标签页的名称和对应字段数据，可直接供幻灯片脚本调用。

自动填充幻灯片函数实现 #

执行逻辑顺序 #

1. 获取当前选中的待填充幻灯片
2. 读取Gsheet对应数据（按需读取用方案2，预读全量用方案1）
3. 解析幻灯片中的占位符，替换为对应数据
4. 完成填充

方案2（更优）的实现代码 #

支持占位符格式为{城市名.aaa}，自动匹配对应标签页的对应字段，无需预生成列表：

var NARRATIVE_SHEETS_URL = '替换为你的Gsheet链接'
const IGNORE_TABS = ["Presentation", "Start", "End", "Raw Data"];
// 替换选中幻灯片的占位符
function replaceSelectedSlides() {
  var selection = SlidesApp.getActivePresentation().getSelection();  
  var selectionType = selection.getSelectionType();
  if (selectionType != SlidesApp.SelectionType.PAGE) return;
  var pages = selection.getPageRange().getPages();
  var ss = SpreadsheetApp.openByUrl(NARRATIVE_SHEETS_URL);
  // 字段对应D列的行号映射，可自行扩展
  var fieldRowMap = {aaa:3, bbb:4, ccc:5, ddd:6};
  // 遍历每个幻灯片做替换
  pages.forEach(page => {
    // 匹配所有{标签名.字段名}格式的占位符
    var placeholders = page.getShapes()
      .map(shape => shape.getText() ? shape.getText().asString().match(/\{(\w+)\.(\w+)\}/g) : null)
      .flat()
      .filter(Boolean);
    placeholders.forEach(ph => {
      // 解析占位符里的标签名和字段名
      var matchRes = ph.match(/\{(\w+)\.(\w+)\}/);
      if (!matchRes) return;
      var [_, sheetName, field] = matchRes;
      if (IGNORE_TABS.includes(sheetName) || !fieldRowMap[field]) return;
      // 按需读取对应标签页的对应字段值
      var sheet = ss.getSheetByName(sheetName);
      if (!sheet) return;
      var value = sheet.getRange(`D${fieldRowMap[field]}`).getValue();
      // 替换占位符
      page.replaceAllText(ph, value);
    })
  })
  Logger.log("全部替换完成");
}

列表方案的填充代码 #

如果选择方案1，用预生成的列表做替换（默认每个幻灯片按顺序对应一个城市标签页）：

function replaceSelectedSlidesWithList() {
  var selection = SlidesApp.getActivePresentation().getSelection();  
  var selectionType = selection.getSelectionType();
  if (selectionType != SlidesApp.SelectionType.PAGE) return;
  var pages = selection.getPageRange().getPages();
  var dataList = getAllSheetDataList();
  // 按顺序匹配幻灯片和城市标签页
  pages.forEach((page, index) => {
    if (!dataList[index]) return;
    var data = dataList[index];
    page.replaceAllText("{aaa}", data.aaa);
    page.replaceAllText("{bbb}", data.bbb);
    page.replaceAllText("{ccc}", data.ccc);
    page.replaceAllText("{ddd}", data.ddd);
  })
}

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