如何通过Google Apps Script提取表格单元格中快捷方式的URL？

核心问题分析 #

你遇到的情况是：单元格显示文档标题，但超链接数据无法通过getRichTextValue().getLinkUrl()获取——这是因为Google Sheets的超链接分两种类型，你之前用错了对应方法：

• 单元格级超链接：给整个单元格设置的链接（右键「插入链接」直接绑定到单元格）
• 富文本超链接：仅单元格内部分文本片段带链接

解决方案 #

1. 获取单元格级超链接（最常见场景） #

使用getHyperlinks()方法可以批量获取整个区域内每个单元格的超链接，无需新增辅助单元格：

function processSpreadsheetLinks() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const targetSheet = spreadsheet.getSheetByName("你的工作表名称"); // 替换为你的表名
  const dataRange = targetSheet.getDataRange();
  
  // 获取所有单元格的文本值和对应超链接（二维数组，与单元格位置一一对应）
  const cellTexts = dataRange.getValues();
  const cellHyperlinks = dataRange.getHyperlinks();

  // 遍历每个单元格
  for (let rowIndex = 0; rowIndex < cellTexts.length; rowIndex++) {
    for (let colIndex = 0; colIndex < cellTexts[rowIndex].length; colIndex++) {
      const title = cellTexts[rowIndex][colIndex];
      const url = cellHyperlinks[rowIndex][colIndex];
      
      if (url) {
        // 这里执行你的业务逻辑：创建文件夹、生成快捷方式等
        console.log(`处理文档：${title}，链接：${url}`);
        // 示例：提取文件ID并创建Drive快捷方式
        // const fileId = url.match(/[-\w]{25,}/)[0];
        // const targetFile = DriveApp.getFileById(fileId);
        // targetFile.makeCopy(`${title} 快捷方式`, 目标文件夹对象);
      }
    }
  }
}

2. 获取富文本内的部分超链接 #

如果单元格内只有部分文本带超链接，需要遍历富文本的文本片段（Run）来提取：

function getRichTextSegmentLinks() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const targetRange = sheet.getDataRange();
  const richTextValues = targetRange.getRichTextValues();

  for (let row = 0; row < richTextValues.length; row++) {
    for (let col = 0; col < richTextValues[row].length; col++) {
      const richText = richTextValues[row][col];
      const textRuns = richText.getRuns();
      
      textRuns.forEach(run => {
        const linkUrl = run.getLinkUrl();
        if (linkUrl) {
          const segmentText = run.getText();
          console.log(`富文本片段：${segmentText}，链接：${linkUrl}`);
        }
      });
    }
  }
}

关键说明 #

• getRichTextValue().getLinkUrl()仅当整个单元格的富文本都绑定同一个链接时才会返回有效URL，否则返回null，这就是你之前方法失效的原因。
• 两种方法都不需要新增单元格，直接在脚本内完成数据提取，完全符合你的需求。

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