Google Sheets API v4 Append请求报错：参数数量不符求助

错误原因 #

你错误地将所有参数打包成单个对象传入Sheets.Spreadsheets.Values.append方法，但Google Apps Script中的该方法要求分参数传递，而非单对象传入，这就是报错Exception: Invalid number of arguments provided. Expected 3-4 only的核心原因。

修正后的代码 #

var spreadsheetId = "你的表格ID";
var sheetName = "你的工作表名称";

// 构造要追加的数据资源
var resource = {
    majorDimension: "ROWS",
    values: [["2018-01-01", "2", "3", "4"]]
};

// 配置可选参数
var optionalArgs = {
    insertDataOption: "INSERT_ROWS",
    responseDateTimeRenderOption: "SERIAL_NUMBER",
    responseValueRenderOption: "FORMATTED_VALUE",
    valueInputOption: "USER_ENTERED",
    includeValuesInResponse: true
};

// 正确调用append方法
var response = Sheets.Spreadsheets.Values.append(
    resource,
    spreadsheetId,
    sheetName + "!A:D",
    optionalArgs
);

// 打印响应结果（可选）
console.log(response);

参数说明 #

• resource：必填，包含要追加的values和数据维度majorDimension，无需重复定义range（方法已通过第三个参数指定）
• spreadsheetId：必填，目标Google表格的ID
• range：必填，要追加数据的工作表范围（格式如工作表名!A:D）
• optionalArgs：可选，包含追加规则、响应格式等配置项，比如valueInputOption控制数据解析方式，insertDataOption控制是否插入新行

额外注意事项 #

• 如果不需要返回追加的数值内容，可将includeValuesInResponse设为false，减少响应数据量
• valueInputOption建议明确指定，默认值可能不符合你的数据输入需求（比如USER_ENTERED会像手动输入一样解析数据，RAW则直接保留原始值）

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