使用Google Sheets API在PHP中获取新建工作表（标签页）的Sheet ID

你遇到的问题核心是没有正确配置batchUpdate请求的fields参数，也没有从响应的replies中提取新工作表的ID。完全不需要调用get接口拉取整个表格信息，直接从batchUpdate的响应里就能拿到目标ID，而且效率更高。

修正后的代码 #

$var1='xxxxxxx'; // 你的现有电子表格ID
try {
    $body = new Google_Service_Sheets_BatchUpdateSpreadsheetRequest(array(
        'requests' => array(
            'addSheet' => array(
                'properties' => array(
                    'title' => 'aaNew ddds'
                )
            )
        )
    ));
    // 修改fields参数，指定要返回的新工作表ID相关字段
    $results = $service->spreadsheets->batchUpdate(trim($var1),$body, [
        'fields' => 'replies.addSheet.properties.sheetId']);
    
    // 从响应的replies中提取新创建的Sheet ID
    if (!empty($results->getReplies())) {
        $newSheetId = $results->getReplies()[0]->getAddSheet()->getProperties()->getSheetId();
        echo "新创建的Sheet ID: ". $newSheetId;
    }
} catch(Exception $e) {
    echo "错误: ". $e->getMessage();
}

关键说明 #

1. 正确的fields参数：
   你之前尝试的sheets(properties(sheetID))是针对spreadsheets.get接口的字段格式，但batchUpdate的响应结构是replies数组（每个请求对应一个回复），所以需要指定replies.addSheet.properties.sheetId来精准获取创建工作表的返回信息。
2. 直接从响应提取：
   调用batchUpdate创建工作表后，Google API会在replies里返回该操作的结果，包含新工作表的完整属性（包括Sheet ID），不需要额外调用get接口，这样能减少API调用次数，避免拉取冗余数据。
3. 错误处理优化：
   建议不要直接忽略异常，至少打印错误信息，方便排查后续可能出现的问题。

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