Google Sheets API batchUpdate请求体格式错误排查及正确写法咨询

你遇到的GoogleJsonResponseException: Requested entity was not found错误，核心是两个格式问题：

1. data字段嵌套错误：你给data套了两层数组[[{...}]]，但官方要求data是单个ValueRange对象组成的数组（即[{...}]）
2. 参数传递顺序错误：Sheets.Spreadsheets.Values.batchUpdate的第一个参数是请求体，第二个才是包含spreadsheetId的配置对象，你搞反了顺序

修正后的完整代码如下：

function outputOccupancyReport() {
    var batchUpdateValuesRequestBody = {
      valueInputOption: "RAW",  
      data: [
        {
          range: "'Occupancy Report'!C5:L5", 
          majorDimension: "ROWS", 
          values: [[0, 0, 0, 0, 0, 0, 0, 0, 0, 0]]
        }
        // 如需批量更新多个区域，直接在这里添加更多对象即可
        // , {range: "'Sheet2'!A1:B2", values: [[1,2],[3,4]]}
      ]  
    };

    Sheets.Spreadsheets.Values.batchUpdate(
      batchUpdateValuesRequestBody, 
      {spreadsheetId: spreadsheetID}
    );
}

关键说明： #

• data数组中的每个元素对应一个独立的更新任务，每个任务需要包含range（目标区域）、values（要写入的数据），majorDimension可选（默认就是ROWS）
• valueInputOption: "RAW"表示直接写入原始值，不需要解析公式或格式

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