Google Sheets API batchUpdate设置格式无效问题求助

我通过Google Sheets API创建了带数据的电子表格，之后尝试给列设置格式。按API文档写的代码，API返回无错误，但格式就是没生效。以下是相关代码、生成的formatDetails数组和API响应，求解决：

const setFormattingGS = async (spreadSheetId, columnTypes, token, tabId) => {
  const formatDetails = [];
 columnTypes.forEach((key, ind) => {
    formatDetails.push({
      repeatCell: {
        range: {
          sheetId: tabId,
          startRowIndex: 1, // skip header
          // endRowIndex: 10, // all rows
          startColumnIndex: ind,
          endColumnIndex: ind + 1,
        },
        cell: {
          userEnteredFormat: {
            numberFormat: {
              type: key,
            },
          },
        },
        fields: "userEnteredFormat.numberFormat",
      },
    });
  });
  console.log(formatDetails);
  const options = {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${token}`,
    },
    body: JSON.stringify({ requests: formatDetails }),
  };
  try {
    const formatApi = await fetch(
      `https://sheets.googleapis.com/v4/spreadsheets/${spreadSheetId}:batchUpdate`,
      options
    );
    const formatRes = await formatApi.json();
    return formatRes;
  } catch (error) {
    console.log("Format Column Error: ", error);
  }
};

我的columnTypes为["TEXT", "NUMBER", "DATE"]，生成的formatDetails数组示例（以TEXT类型列为例）：

{
  repeatCell: {
    cell: {
      userEnteredFormat: {
        numberFormat: { type: 'TEXT' }
      }
    },
    fields: "userEnteredFormat.numberFormat",
    range: {
      endColumnIndex: 1,
      sheetId: 1274287844,
      startColumnIndex: 0,
      startRowIndex: 1
    }
  }
}

API返回的响应内容：

{
  spreadsheetId: '1mQTykC8aCWJY1Y1nhhOIh9YuBJ-i2yvg0lCbA-X09Wc',
  replies: [{}, {}, {}]
}

1. 明确endRowIndex覆盖所有数据行 #

代码里注释掉了endRowIndex，Google Sheets API的range如果不指定该参数，默认只会应用到startRowIndex对应的那一行（也就是第2行，索引从0开始）。要覆盖所有有数据的行，要么指定一个足够大的数值（比如1000，超出实际数据行数也不影响），要么先通过API获取表格有效行数再设置：

range: {
  sheetId: tabId,
  startRowIndex: 1,
  endRowIndex: 1000, // 覆盖足够多的行
  startColumnIndex: ind,
  endColumnIndex: ind + 1,
}

2. 给DATE类型补充格式模板 #

当numberFormat.type为DATE时，仅指定type可能无法触发格式生效，需要补充pattern明确日期格式：

numberFormat: {
  type: key,
  ...(key === 'DATE' && { pattern: 'yyyy-mm-dd' }) // 可根据需求调整格式
}

3. 检查数据与格式的匹配性 #

确保列内原始数据和设置的格式类型匹配：

• TEXT类型：如果单元格是数字/日期，设置TEXT格式不会自动转换数据类型，仅改变显示样式；若需强制转文本，需额外通过updateCells请求修改单元格值类型。
• NUMBER/DATE类型：单元格内数据必须是可被识别为数字/日期的格式，否则格式设置不会生效。

4. 验证权限范围 #

确认OAuth token包含https://www.googleapis.com/auth/spreadsheets权限，该权限允许修改表格格式；只读权限会导致格式设置静默失败（你的API返回成功，此点大概率没问题，但可作为排查项）。

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