使用Google Apps Script从Sheet导入数据到Slide时部分占位符未替换

我用Google Apps Script将Google Sheets的值导入到指定Slide模板的占位符中，但幻灯片里的{{C19}}、{{C20}}、{{C23}}这几个占位符始终无法被替换，代码片段如下：

function createOffer() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
  var slides = SlidesApp.openByUrl("https://docs.google.com/presentation/d/1bf-3ypg-lGE9_ju_vCUHeQZj0eWiuFRzxIV_9Ap4eaw/edit#slide=id.g2cece5ff8dd_0_76");
  replacePlaceholdersInSlide(slides, sheet);
}

function replacePlaceholdersInSlide(slides, sheet) {
  var slide = slides.getSlides()[0]; // First slide
  var shapes = slide.getShapes();
  var placeholderValuePairs = {
    "{{C10}}": "C10","{{C19}}": "C19","{{C20}}": "C20","{{C23}}": "C23","{{D19}}": "D19",
    "{{C40}}": "C40"
  };
  replacePlaceholdersInShapes(shapes, placeholderValuePairs, sheet);
}


function replacePlaceholdersInShapes(shapes, placeholderValuePairs, sheet) {

  shapes.forEach(function(shape) {
    if (shape.getText) { 
      var text = shape.getText(); 
      for (var placeholder in placeholderValuePairs) {
        var newValue = sheet.getRange(placeholderValuePairs[placeholder]).getDisplayValue();
        text.replaceAllText(placeholder, newValue);
      }
    }
  });
}

可能原因及排查/解决方法 #

1. 占位符格式不匹配 #

• 排查：检查幻灯片中{{C19}}等占位符，确保和代码中的字符串完全一致，没有多余空格、换行、大小写差异（比如是不是写成了{{ c19 }}）。
• 解决：手动修正幻灯片中的占位符，保证和代码里的键完全一致。

2. 占位符位于分组形状内 #

slide.getShapes()只能获取顶层形状，如果未替换的占位符在分组（Group）里，代码会忽略这些形状。

• 解决：修改代码，遍历分组内的子形状：

function replacePlaceholdersInSlide(slides, sheet) {
  var slide = slides.getSlides()[0];
  var placeholderValuePairs = {
    "{{C10}}": "C10","{{C19}}": "C19","{{C20}}": "C20","{{C23}}": "C23","{{D19}}": "D19",
    "{{C40}}": "C40"
  };
  
  // 处理顶层形状
  replacePlaceholdersInShapes(slide.getShapes(), placeholderValuePairs, sheet);
  // 处理分组内的形状
  slide.getGroups().forEach(group => {
    group.getChildren().forEach(child => {
      if (child.getPageElementType() === SlidesApp.PageElementType.SHAPE) {
        replacePlaceholdersInShapes([child.asShape()], placeholderValuePairs, sheet);
      }
    });
  });
}

function replacePlaceholdersInShapes(shapes, placeholderValuePairs, sheet) {
  shapes.forEach(function(shape) {
    if (shape.getText) { 
      var text = shape.getText(); 
      for (var placeholder in placeholderValuePairs) {
        var cellRef = placeholderValuePairs[placeholder];
        var newValue = sheet.getRange(cellRef).getDisplayValue();
        // 日志排查：查看是否获取到正确的单元格值
        Logger.log(`占位符${placeholder}对应单元格${cellRef}的值：${newValue}`);
        text.replaceAllText(placeholder, newValue);
      }
    }
  });
}

3. 单元格值为空或未正确获取 #

• 排查：运行代码后查看App Script的日志（点击「查看」→「日志」），确认{{C19}}对应的单元格值是否被正确读取。如果日志里显示newValue为空，检查Sheet1中C19单元格是否有内容。
• 解决：确保目标单元格有值，或者在代码中添加空值处理逻辑（比如替换为空时显示默认文本）。

4. 幻灯片索引错误 #

• 排查：确认getSlides()[0]是包含这些占位符的幻灯片（Slide索引从0开始）。如果占位符不在第一张幻灯片，调整索引值。
• 解决：修改slides.getSlides()[0]为对应的索引，比如第二张用getSlides()[1]。

5. Slide URL带锚点导致的问题 #

打开幻灯片的URL包含锚点#slide=id...，虽然openByUrl通常能处理，但建议使用不带锚点的基础URL：

var slides = SlidesApp.openByUrl("https://docs.google.com/presentation/d/1bf-3ypg-lGE9_ju_vCUHeQZj0eWiuFRzxIV_9Ap4eaw/edit?usp=sharing");

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