Google Sheets API无法向受保护列追加数据问题求助

问题原因 #

使用values:append接口追加行时，若目标列处于隐藏状态，接口会默认跳过隐藏列，导致数据错位——原本应写入A列的内容被自动填充到第一个可见列（B列），最终A列无数据，后续列内容前移。你的保护设置（warningOnly: true+requestingUserCanEdit: true）并未限制授权用户的编辑权限，因此权限不是问题核心。

解决方案 #

方案1：使用batchUpdate的appendCells接口替代values:append

该接口可精准控制写入位置，不受列隐藏状态影响，直接指定单元格写入内容：

const appendOptions = {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    requests: [
      {
        appendCells: {
          sheetId: tabId,
          rows: [
            {
              values: [
                { userEnteredValue: { stringValue: data[0][0] } }, // 写入A列
                { userEnteredValue: { stringValue: data[0][1] } }, // 写入B列
                { userEnteredValue: { stringValue: data[0][2] } }  // 写入C列
              ]
            }
          ],
          fields: "userEnteredValue"
        }
      }
    ]
  })
};

try {
  const appendRes = await fetch(
    `https://sheets.googleapis.com/v4/spreadsheets/${spreadSheetId}:batchUpdate`,
    appendOptions
  );
  const result = await appendRes.json();
  console.log(result);
} catch (error) {
  console.log("Append Error: ", error);
}

方案2：修改values:append请求参数，强制包含隐藏列

在URL中明确指定完整数据范围（如A:C），并设置insertDataOption=INSERT_ROWS，让接口识别到隐藏列的存在：

var result = await fetch(
  `https://sheets.googleapis.com/v4/spreadsheets/${spreadSheetId}/values/${sheetName}!A:C:append?valueInputOption=USER_ENTERED&insertDataOption=INSERT_ROWS`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${token}`,
    },
    body: JSON.stringify({ values: data }),
  }
)
.then((response) => response.json())
.catch((error) => console.log("Update Sheet Error: ", error));

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