JavaScript实现Google Sheets指定列追加日期：为何C列追加失效？

Google Sheets API 的 spreadsheets.values.append 方法默认使用 OVERWRITE 作为 insertDataOption 参数值。当你指定范围为 FV1!C:C 但目标C列无数据，而工作表中其他列（比如A列）存在连续数据时，API会将这些有数据的列视为一个“表格”，并把数据追加到该表格的下一行的第一列，而非你指定的C列。

在请求参数 params 中添加 insertDataOption: 'INSERT_ROWS'，强制API在指定列的末尾插入新行并写入数据，而非基于整个工作表的现有表格区域追加。

修改后的完整代码：

//update tasks
function fv1Passivated() {
  var in_date = new Date();
  var str = in_date.getDate() +'/'+(in_date.getMonth()+1)+'/'+in_date.getFullYear()

  var params = {
      spreadsheetId: SHEET_ID,
      range: 'FV1!C:C', 
      valueInputOption: 'RAW',
      insertDataOption: 'INSERT_ROWS' // 新增参数，指定插入新行
  };

  var valueRangeBody = {
      "values": [
         [str]
      ]
  };

  console.log(valueRangeBody);
  var request = gapi.client.sheets.spreadsheets.values.append(params, valueRangeBody);
  request.then(function(response) {
    console.log(response.result);
  }, function(reason) {
    console.error('error: ' + reason.result.error.message);
  });
}

如果希望Google Sheets自动识别日期格式而非存储为字符串，可以直接传入Date对象，并将 valueInputOption 设置为 USER_ENTERED：

//update tasks
function fv1Passivated() {
  var in_date = new Date();

  var params = {
      spreadsheetId: SHEET_ID,
      range: 'FV1!C:C', 
      valueInputOption: 'USER_ENTERED', // 让API按用户输入格式解析数据
      insertDataOption: 'INSERT_ROWS'
  };

  var valueRangeBody = {
      "values": [
         [in_date] // 直接传入Date对象
      ]
  };

  console.log(valueRangeBody);
  var request = gapi.client.sheets.spreadsheets.values.append(params, valueRangeBody);
  request.then(function(response) {
    console.log(response.result);
  }, function(reason) {
    console.error('error: ' + reason.result.error.message);
  });
}

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