如何用Google App Script向Google Sheet添加含可点击链接的行？

我想在Google Sheet中添加包含可点击链接的行，尝试用RichText实现，但生成的单元格只显示“RichTextValue”，无法达到预期的可点击链接效果。我的代码如下：

function addCourseLink(course) {
  var courseCode = course.slice(0, 3) + "-" + course.slice(3, course.length)
  var richText = SpreadsheetApp.newRichTextValue()
    .setText('Visit this website')
    .setLinkUrl(`https://url.com/${courseCode}/`)
    .build();
  return richText
}

function createRows(averages) {
  const rows = [];
  for (const semester in averages) {
    const courseGrades = averages[semester];
    for (const course in courseGrades) {
      const grade = courseGrades[course];
      rows.push([addCourseLink(course), semester, grade]);
    }
  }
  return rows;
}

问题根源 #

直接将RichTextValue对象放入数组后用setValues()写入Sheet，会被自动转换为字符串输出，所以单元格显示的是对象标识“RichTextValue”，而非渲染后的富文本链接。

修改后的代码 #

需要使用setRichTextValues()方法专门处理富文本内容，拆分富文本列和普通数据列分别写入：

function addCourseLink(course) {
  var courseCode = course.slice(0, 3) + "-" + course.slice(3);
  return SpreadsheetApp.newRichTextValue()
    .setText('Visit this website')
    .setLinkUrl(`https://url.com/${courseCode}/`)
    .build();
}

function createRows(averages) {
  const rows = [];
  for (const semester in averages) {
    const courseGrades = averages[semester];
    for (const course in courseGrades) {
      const grade = courseGrades[course];
      rows.push([addCourseLink(course), semester, grade]);
    }
  }
  return rows;
}

// 新增写入Sheet的函数，正确处理富文本
function writeToSheet(averages) {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const rows = createRows(averages);
  const startRow = sheet.getLastRow() + 1;
  const range = sheet.getRange(startRow, 1, rows.length, rows[0].length);

  // 拆分富文本列和普通数据列
  const richTextColumn = rows.map(row => [row[0]]);
  const normalColumns = rows.map(row => [row[1], row[2]]);

  // 分别设置富文本和普通值
  range.offset(0, 0, rows.length, 1).setRichTextValues(richTextColumn);
  range.offset(0, 1, rows.length, 2).setValues(normalColumns);
}

关键说明 #

• setRichTextValues()方法接收二维数组形式的RichTextValue对象，能让Sheet正确解析并渲染带链接的富文本。
• 如果只需要单独设置某个单元格，也可以用sheet.getRange(row, col).setRichTextValue(richText)实现。

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