如何基于Google Sheets关键词-链接映射批量为Google Docs插入对应超链接

• setLinkUrl 方法调用逻辑错误：Google Docs的Body类setLinkUrl接收的参数是「文本起始位置、文本结束位置、超链接地址」，直接传入「关键词、链接」无法被识别，脚本不会自动搜索文档内匹配的关键词位置。
• 冗余操作过多：反复设置活跃表格、重复获取同一个工作表的操作无意义，还会增加执行耗时。
• 范围取值错误：计算dc = dongcuoi +1会多读取一行无数据的空行，浪费资源。
• 只处理单个文档：内层循环加了break，导致每个文件夹下只会处理第一个找到的Google Docs文件，无法批量处理全部文档。
• 无关键词匹配逻辑：没有搜索文档内关键词位置的逻辑，无法实现多位置、多次出现的关键词绑定链接的需求。

function insertLinksToDocs() {
  // 读取关键词和链接映射表
  const linkSheet = SpreadsheetApp.open(DriveApp.getFilesByName('Set Link').next()).getSheetByName('Trang tính1');
  const linkPairs = linkSheet.getDataRange().getValues().filter(row => row[0] && row[1]); // 过滤空行

  // 获取目标文件夹下所有Google Docs文件
  const targetFolders = DriveApp.getFoldersByName('test3');
  while (targetFolders.hasNext()) {
    const folder = targetFolders.next();
    const docFiles = folder.getFilesByType(MimeType.GOOGLE_DOCS);
    
    while (docFiles.hasNext()) {
      const doc = DocumentApp.openById(docFiles.next().getId());
      const body = doc.getBody();

      // 遍历所有关键词-链接对
      linkPairs.forEach(([keyword, linkUrl]) => {
        let rangeElement = body.findText(keyword);
        // 匹配所有出现的关键词
        while (rangeElement) {
          const startOffset = rangeElement.getStartOffset();
          const endOffset = rangeElement.getEndOffsetInclusive();
          rangeElement.getElement().asText().setLinkUrl(startOffset, endOffset, linkUrl);
          // 搜索下一个匹配项
          rangeElement = body.findText(keyword, rangeElement);
        }
      });

      doc.saveAndClose();
      Utilities.sleep(300); // 避免触发API调用频率限制
    }
  }
}

• 确保你的Google账号对「Set Link」表格、test3文件夹及文件夹内的所有Docs文件都有编辑权限。
• 如果关键词需要区分大小写，可以对findText方法传入额外的匹配规则参数，默认不区分大小写。
• 如果包含带特殊符号的关键词，需要提前做转义处理，避免匹配逻辑出错。
• 首次运行需要授权脚本权限，按照系统提示允许对应权限即可。

内容的提问来源于stack exchange，提问作者Hạnh Khánh