PHP调用Google Sheets API batchUpdate报valueInputOption未指定错误

• 原有业务代码运行正常，近期调用Google Sheets API的batchUpdate()方法时返回错误：'valueInputOption' is required but not specified
• 代码逻辑为：先清空Sheet指定范围单元格，再批量写入多行业务数据，最后写入统计总计行
• 代码中已在构造批量更新请求对象时传入valueInputOption参数，但仍提示参数缺失

这是PHP版Google API客户端升级导致的兼容问题：
旧版本客户端支持实例化API请求类时传入关联数组，自动完成属性映射赋值；近期发布的新版本调整了部分服务类的构造逻辑，不再自动处理传入的关联数组参数，直接导致构造参数里写的valueInputOption没有被实际赋值到请求对象上，API收到的请求体缺失该必填字段，因此触发报错。
你可以在构造完请求对象后打印$batchBody->getValueInputOption()，如果返回值为NULL即可确认该问题。
之前代码能正常运行，一般是因为项目依赖没有锁版本，近期执行依赖更新时自动升级到了存在兼容变更的客户端版本。

不要依赖构造函数传关联数组赋值，实例化请求对象后显式调用官方提供的setter方法设置参数，将原有构造$batchBody的代码段替换为以下内容即可：

$batchBody = new Google_Service_Sheets_BatchUpdateValuesRequest();
$batchBody->setValueInputOption('USER_ENTERED');
$batchBody->setData($cell_values);

• 当前总计行的EPC计算逻辑没有做除零判断，当总点击数为0时会抛出除以0的警告，建议将对应代码替换为带判断的逻辑：

  // 原有逻辑：round(($totals['revenue'] / $totals['clicks']), 2)
  // 替换为
  $totals['clicks'] > 0 ? round($totals['revenue'] / $totals['clicks'], 2) : 0
  

• 建议在项目composer.json中锁定google/apiclient的依赖版本，避免无感知自动升级带来的非预期兼容问题。

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