Google Apps Script中ContentService.createTextOutput丢失数组结构问题

问题原因 #

直接用ContentService.createTextOutput(values)返回二维数组时，Google Apps Script会自动将数组扁平化，转换为逗号分隔的纯文本，导致原本的二维层级结构完全丢失。

解决方案 #

将二维数组序列化为JSON格式字符串后再返回，就能完整保留数组的层级结构。

代码示例 #

错误写法（丢失结构）

function getAllProducts() {
  // 假设已通过Sheets API获取到二维数组values
  const values = Sheets.Spreadsheets.Values.get('你的表格ID', '目标范围').values;
  // 这里返回的是扁平化的逗号分隔文本
  return ContentService.createTextOutput(values);
}

正确写法（保留结构）

function getAllProducts() {
  const values = Sheets.Spreadsheets.Values.get('你的表格ID', '目标范围').values;
  
  // 将二维数组转为JSON字符串，保留层级结构
  const jsonStr = JSON.stringify(values);
  
  // 返回JSON格式内容（指定MIME类型更规范，也可省略setMimeType用默认文本类型）
  return ContentService.createTextOutput(jsonStr)
    .setMimeType(ContentService.MimeType.JSON);
}

可选优化：处理空单元格 #

Sheets API返回的空单元格可能会被序列化为null，如果需要将空值转为空字符串，可以提前处理数组：

function getAllProducts() {
  const values = Sheets.Spreadsheets.Values.get('你的表格ID', '目标范围').values;
  
  // 遍历数组，将undefined/null转为空字符串
  const processedValues = values.map(row => 
    row.map(cell => cell == null ? "" : cell)
  );
  
  const jsonStr = JSON.stringify(processedValues);
  return ContentService.createTextOutput(jsonStr)
    .setMimeType(ContentService.MimeType.JSON);
}

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