如何正确创建并初始化GTLRSheets_ValueRange以更新Google Sheets？

你遇到的核心问题是错误构造了GTLRSheets_ValueRange的values数据结构。Google Sheets API要求values必须是二维数组（外层数组代表行，内层子数组代表该行的列值），而不是以范围字符串为键的字典。你当前代码把A328:A作为字典键存储值，导致API识别到非法字段a328:_a，直接触发报错。

错误原因拆解 #

看你输出的调试日志：

OK: ( { "A328:A" = test; } )

这说明你构建的data是一个包含字典的数组，字典键是范围字符串——这完全不符合API的请求格式规范。API不需要在values里指定范围，范围是通过queryWithObject:spreadsheetId:range:方法的range参数单独指定的。

正确实现步骤&代码 #

下面是修正后的完整代码，我会逐部分解释逻辑：

1. 构建合规的values数组：
   要更新A328:A（单行单列），我们需要构造二维数组@[@[@"test"]]——外层数组对应行，内层数组对应该行的列值。如果是多行多列（比如更新A328:B329），则写成@[@[@"val1", @"val2"], @[@"val3", @"val4"]]。

2. 初始化GTLRSheets_ValueRange对象：
   直接给对象的values属性赋值，或者用正确的字典结构初始化，确保@"values"对应的是二维数组而非带范围键的字典。

3. 设置关键请求参数：
   必须给query设置valueInputOption，这个参数决定API如何解析你传入的值：

   • GTLRSheets_ValueInputOption_Raw：直接按原始值写入（适合纯文本、数字）
   • GTLRSheets_ValueInputOption_UserEntered：像用户手动输入一样解析（支持公式、日期格式等）

// 1. 构建正确的二维数组：对应要更新的单元格值
NSArray *values = @[@[@"test"]]; 

// 2. 初始化ValueRange对象（两种方式二选一即可）
// 方式一：直接赋值属性
GTLRSheets_ValueRange *valueRange = [[GTLRSheets_ValueRange alloc] init];
valueRange.values = values;

// 方式二：用字典初始化
// NSMutableDictionary *datum = @{@"values": values}.mutableCopy;
// GTLRSheets_ValueRange *valueRange = [GTLRSheets_ValueRange objectWithJSON:datum];

// 3. 创建更新请求，指定范围和值输入选项
GTLRSheetsQuery_SpreadsheetsValuesUpdate *query2 = 
    [GTLRSheetsQuery_SpreadsheetsValuesUpdate queryWithObject:valueRange 
                                               spreadsheetId:spreadsheetId 
                                                       range:superRange];
// 根据业务需求选择输入选项
query2.valueInputOption = GTLRSheets_ValueInputOption_Raw;

// 执行请求
[self.service executeQuery:query2 delegate:self didFinishSelector:@selector(displayResultWithTicket:finishedWithObject:error:)];

验证修正效果 #

修正后你的调试日志里的values结构会变成：

OK: ( { values = ( (test) ); } )

这样API就能正确识别请求格式，顺利完成单元格更新操作。

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