使用Google Sheets API（JavaScript）写入表格时出现错误

嘿，欢迎来Stack Overflow！第一次提问完全不用紧张，咱们一步步排查你遇到的Google Sheets API写入问题～

从你给出的代码片段来看，有几个关键问题很可能导致写入失败，咱们逐个解决：

1. 范围（Range）格式不正确 #

你写的range:'!G1:G5'缺少了工作表名称，Google Sheets API需要明确指定要操作的具体工作表（比如默认的Sheet1），否则API找不到要写入的位置。修正后应该是：

range:'Sheet1!G1:G5'

如果你的表格有自定义工作表名称，直接替换成对应的名字就行，比如'销售数据!G1:G5'。

2. valueInputOption参数不完整 #

你的代码里这个参数只写了一半，它是写入请求的必填项，用来告诉API如何解析你传入的值。常用的两个选项：

• 'RAW'：直接写入原始值，不会自动转换格式（比如不会把字符串转成日期或数字）
• 'USER_ENTERED'：模拟用户手动输入的行为，会自动转换格式（比如输入'1/2'会被识别为日期）

你需要把这个参数补全，比如：

valueInputOption: 'RAW'

3. 权限范围（Scope）不足 #

读取正常但写入失败，大概率是授权时只请求了只读权限。你需要检查授权用的Scope，把只读的https://www.googleapis.com/auth/spreadsheets.readonly换成有写入权限的Scope，比如：

• https://www.googleapis.com/auth/spreadsheets：允许读写所有你有权限访问的表格
• https://www.googleapis.com/auth/drive.file：只允许读写通过你的应用创建或明确授权的表格（更安全，推荐）

4. 数据传递方式错误 #

还有个容易忽略的细节：spreadsheets.values.update方法需要把数据放在resource参数里，而不是直接传body，这也是很多人踩坑的点！

修复后的完整代码示例 #

把以上问题修正后，你的代码应该类似这样：

var values = [ 
  [ "CO16338","CO16331","CO16330" ], 
]; 
var body = { values: values }; 

gapi.client.sheets.spreadsheets.values.update({
  spreadsheetId: '1k1s95YiuWMjeOCMmpj8DQaj705ZC6Uq4UC7pEEU0zko',
  range: 'Sheet1!G1:G5', // 补全工作表名称
  valueInputOption: 'RAW', // 完整指定参数
  resource: body // 正确传递数据
}).then(function(response) {
  console.log('写入成功！更新了 ' + response.result.updatedCells + ' 个单元格');
}, function(error) {
  console.error('写入失败，错误信息:', error.result.error.message);
});

如果还是报错，建议在错误回调里打印完整的error.result.error，这样能更精准定位问题（比如权限不足、范围不存在等）。

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