如何使用Node.js与Google Sheets V4 API读取单元格底层链接？

你当前用的spreadsheets.values.get只能获取单元格的值层面内容（文本、公式、格式化值），而单元格的超链接属于单元格的格式属性，不在值的返回范围内，所以得换用spreadsheets.get接口来获取单元格的元数据。

具体解决方案 #

1. 修改API调用方式 #

改用googleSheetsInstance.spreadsheets.get，通过fields参数指定只返回我们需要的超链接和显示文本，避免返回冗余数据。

2. 完整代码示例 #

const auth = new google.auth.GoogleAuth({
  keyFile: "./keys/key.json",
  scopes: "https://www.googleapis.com/auth/spreadsheets", 
});
const authClientObject = await auth.getClient();
const googleSheetsInstance = google.sheets({ version: "v4", auth: authClientObject });

const spreadsheetId = "你的表格ID";

// 改用spreadsheets.get获取单元格元数据
const readData = await googleSheetsInstance.spreadsheets.get({
  spreadsheetId,
  ranges: ["Sheet!D:D"], // 指定要读取的范围
  fields: "sheets(data(rowData(values(hyperlink,formattedValue))))", // 过滤只返回超链接和显示文本
});

// 解析返回的数据，提取超链接和显示文本
const sheetData = readData.data.sheets[0].data[0];
if (sheetData?.rowData) {
  const links = sheetData.rowData.map(row => {
    const cell = row?.values?.[0];
    return cell ? {
      displayText: cell.formattedValue,
      url: cell.hyperlink
    } : null;
  }).filter(item => item !== null); // 过滤空单元格
  
  console.log("提取到的链接数据：", links);
}

关键说明 #

• fields参数是核心：它用来指定API返回的字段，这里我们只请求hyperlink（超链接URL）和formattedValue（单元格显示文本），减少数据传输量。
• 处理空单元格：需要判断row和cell是否存在，避免报错。
• 权限范围不变：你原来用的https://www.googleapis.com/auth/spreadsheets权限已经足够访问这些元数据。

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