如何通过spreadsheets.batchUpdate将CSV数字以文本格式导入表格保留前导零？

我从CSV读取数据后，以逗号为分隔符粘贴到Google Sheets表格中，希望将CSV里带前导零的数字（比如0003928371）以文本格式存入表格，保留前导零。请问有什么可行方法？

现有代码如下：

function populateSheet(sheetsAPI, csvData, sheetId) {
  return new Promise((resolve, reject) => {
    const dataAndStyle = {
      spreadsheetId: process.env.SPREADSHEET_ID,
      resource: {
        requests: [
          {
            pasteData: {
              coordinate: {
                sheetId: sheetId,
                rowIndex: 1,
                columnIndex: 0
              },
              data: csvData,
              delimiter: ","
            }
          }
        ]
      }
    };
        
    sheetsAPI.spreadsheets.batchUpdate(dataAndStyle, function(err) {
      if (err) {
        reject("The Sheets API returned an error: " + err);
      } else {
        console.log(sheetId + " sheet populated with " + csvData.length + " rows and column style set.");
        resolve();
      }
    });    
  });
}

我原本想使用valueInputOptions: "RAW"参数，但该参数仅适用于spreadsheets.values.batchUpdate，无法在spreadsheets.batchUpdate中使用。

有两种可行的思路可以实现需求：

方案一：预处理CSV数据，添加文本标识 #

Google Sheets会将以单引号'开头的内容识别为文本格式，且单引号不会显示在单元格中。可以在粘贴前预处理CSV数据，给带前导零的数字字段添加单引号前缀：

function populateSheet(sheetsAPI, csvData, sheetId) {
  // 预处理CSV：给带前导零的数字字段添加单引号前缀
  const processedCsv = csvData.split('\n').map(row => {
    return row.split(',').map(cell => {
      const trimmedCell = cell.trim();
      // 判断是否是带前导零的纯数字，可根据实际需求调整判断逻辑
      if (/^0+\d+$/.test(trimmedCell)) {
        return `'${trimmedCell}`;
      }
      return trimmedCell;
    }).join(',');
  }).join('\n');

  return new Promise((resolve, reject) => {
    const dataAndStyle = {
      spreadsheetId: process.env.SPREADSHEET_ID,
      resource: {
        requests: [
          {
            pasteData: {
              coordinate: {
                sheetId: sheetId,
                rowIndex: 1,
                columnIndex: 0
              },
              data: processedCsv,
              delimiter: ","
            }
          }
        ]
      }
    };
        
    sheetsAPI.spreadsheets.batchUpdate(dataAndStyle, function(err) {
      if (err) {
        reject("The Sheets API returned an error: " + err);
      } else {
        console.log(sheetId + " sheet populated with " + csvData.length + " rows and column style set.");
        resolve();
      }
    });    
  });
}

如果只需要针对特定列处理，可在遍历单元格时加入列索引判断，进一步精准控制。

方案二：改用spreadsheets.values.batchUpdate接口 #

既然valueInputOption: "RAW"参数仅支持该接口，可将CSV解析为二维数组后使用该接口写入，直接保留原始格式：

function populateSheet(sheetsAPI, csvData, sheetId) {
  // 将CSV解析为二维数组
  // 注意：复杂CSV（含换行、转义逗号）建议使用专业库如`csv-parser`解析
  const values = csvData.split('\n').map(row => row.split(',').map(cell => cell.trim()));

  return new Promise((resolve, reject) => {
    const requestBody = {
      spreadsheetId: process.env.SPREADSHEET_ID,
      resource: {
        valueInputOption: "RAW",
        data: [
          {
            range: {
              sheetId: sheetId,
              startRowIndex: 1,
              startColumnIndex: 0
            },
            values: values
          }
        ]
      }
    };
        
    sheetsAPI.spreadsheets.values.batchUpdate(requestBody, function(err) {
      if (err) {
        reject("The Sheets API returned an error: " + err);
      } else {
        console.log(sheetId + " sheet populated with " + values.length + " rows.");
        resolve();
      }
    });    
  });
}

RAW模式会让Sheets API直接写入原始值，不会自动转换数字格式，因此带前导零的内容会被保留为文本。

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