如何获取Google Slides占位符ID？文本识别脚本未生效

我通过编辑Google Slides主题创建了一个文本占位符，希望动态插入内容，因此需要获取它的唯一ID。为了识别该占位符，我在其中输入了文本"Placeholder 1"，并编写了如下脚本尝试根据文本提取ID：

function findPlaceholderIdByText() {
  // Google Slides presentation ID
  var presentationId = "1BSmYn9SMbZ9jN4_cwgndSaNDLhite_L8GUiN_V3nTAs"; // Replace with your presentation ID

  // Open the Google Slides presentation
  console.log("Opening the Google Slides presentation...");
  var presentation = SlidesApp.openById(presentationId);
  console.log("Google Slides presentation opened.");

  var slide = presentation.getSlides()[0]; // Assuming you're working with the first slide
  var pageElements = slide.getPageElements();
  
  // Loop through page elements and find the placeholder with the specified text
  for (var i = 0; i < pageElements.length; i++) {
    var pageElement = pageElements[i];
    console.log("Checking page element: " + pageElement.getObjectId());
    if (pageElement.asShape().getText().getText() === "Placeholder 1") {
      var placeholderId = pageElement.getObjectId();
      console.log("Found placeholder with text 'Placeholder 1'. Placeholder ID: " + placeholderId);
      break; // Assuming there's only one placeholder with this text
    }
  }
}

但执行脚本后仅得到以下输出，未找到目标占位符ID：

2:28:52 PM Notice Execution started
2:28:53 PM Info Opening the Google Slides presentation...
2:28:53 PM Info Google Slides presentation opened.
2:28:53 PM Notice Execution completed

问题原因 #

原脚本存在两个核心问题：

1. 遍历范围错误：主题中创建的占位符存储在演示文稿的**母版（Master）或其关联的布局（Layout）**中，并非直接在幻灯片的页面元素列表里，所以遍历幻灯片元素无法找到目标。
2. 类型处理错误：直接调用pageElement.asShape()会导致非形状类型的元素（如原生占位符）报错，中断遍历流程。

修正后的脚本 #

function findPlaceholderIdByText() {
  const presentationId = "1BSmYn9SMbZ9jN4_cwgndSaNDLhite_L8GUiN_V3nTAs";
  const targetText = "Placeholder 1";

  console.log("打开Google Slides演示文稿...");
  const presentation = SlidesApp.openById(presentationId);
  console.log("演示文稿已打开");

  // 遍历所有母版（主题占位符的存储位置）
  const masters = presentation.getMasters();
  for (const master of masters) {
    console.log(`检查母版: ${master.getObjectId()}`);
    checkPageElements(master.getPageElements(), targetText);
    
    // 遍历母版下的所有布局
    const layouts = master.getLayouts();
    for (const layout of layouts) {
      console.log(`检查布局: ${layout.getObjectId()}`);
      checkPageElements(layout.getPageElements(), targetText);
    }
  }

  // 额外检查幻灯片中的占位符实例（若已应用主题到幻灯片）
  const slide = presentation.getSlides()[0];
  console.log(`检查幻灯片: ${slide.getObjectId()}`);
  checkPageElements(slide.getPageElements(), targetText);
}

// 封装元素检查逻辑
function checkPageElements(pageElements, targetText) {
  for (const element of pageElements) {
    const elementId = element.getObjectId();
    console.log(`检查元素ID: ${elementId}`);
    
    // 检查是否为原生占位符
    if (element.getPageElementType() === SlidesApp.PageElementType.PLACEHOLDER) {
      const textContent = element.asPlaceholder().getText().getText().trim();
      if (textContent === targetText) {
        console.log(`找到目标占位符！ID: ${elementId}`);
        return;
      }
    } 
    // 检查是否为转换后的普通形状
    else if (element.getPageElementType() === SlidesApp.PageElementType.SHAPE) {
      const textContent = element.asShape().getText().getText().trim();
      if (textContent === targetText) {
        console.log(`找到目标形状（原占位符）！ID: ${elementId}`);
        return;
      }
    }
  }
}

修正说明 #

• 扩大遍历范围：包含母版和布局，覆盖主题占位符的存储位置
• 类型安全判断：先检查元素类型，再进行对应转换，避免报错中断遍历
• 文本格式兼容：用trim()去除文本首尾的空格或换行，解决因格式差异导致的匹配失败
• 逻辑拆分：将元素检查封装为独立函数，提升代码可读性

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