Google Sheets API/PHP：如何用A1表示法抓取非连续列

你踩的这个坑我之前也遇到过——spreadsheets_values->get()方法根本不支持在单个range参数里用逗号分隔多个非连续范围，这就是报错的核心原因。Google Sheets API的这个方法只认单个连续的单元格范围，要获取非连续列得换两种思路来实现：

方案1：用batchGet方法批量获取多个非连续范围 #

这是最官方的解决方案，专门用来获取多个不连续的区域数据，代码大概是这样：

// 把你需要的非连续范围单独列出来
$targetRanges = [
    'LPs Input!C:D',
    'LPs Input!O:P'
];

// 调用batchGet接口，传入多个范围
$response = $service->spreadsheets_values->batchGet($spreadsheetId, ['ranges' => $targetRanges]);
$valueSets = $response->getValueRanges();

// 遍历返回的结果，每个结果对应一个你指定的范围
foreach ($valueSets as $idx => $valueSet) {
    $data = $valueSet->getValues();
    // 比如第一个结果是C:D的数据，第二个是O:P的
    if ($idx === 0) {
        echo "=== 列C-D的数据 ===\n";
        foreach ($data as $row) {
            print_r($row);
        }
    } else {
        echo "=== 列O-P的数据 ===\n";
        foreach ($data as $row) {
            print_r($row);
        }
    }
}

这个方法的好处是精准拉取，不会获取多余数据，适合数据量特别大的表格，能省不少带宽和处理时间。

方案2：拉取包含目标列的连续大范围，本地筛选需要的列 #

如果你的目标列都在一个不算太大的连续范围内（比如你要的C、D、O、P都在A-P里），那直接拉取这个大范围，然后在代码里过滤出需要的列反而更简单：

// 拉取覆盖所有目标列的连续范围
$range = 'LPs Input!A:P';
$response = $service->spreadsheets_values->get($spreadsheetId, $range);
$allValues = $response->getValues();

// 定义需要保留的列索引（注意是从0开始算：A=0，B=1，C=2，D=3，O=14，P=15）
$keepColumns = [2, 3, 14, 15];

// 逐行筛选列
$filteredData = [];
foreach ($allValues as $row) {
    $filteredRow = [];
    foreach ($keepColumns as $colIdx) {
        // 加个判断避免行长度不够导致索引越界
        $filteredRow[] = isset($row[$colIdx]) ? $row[$colIdx] : '';
    }
    $filteredData[] = $filteredRow;
}

// 输出筛选后的数据
print_r($filteredData);

这种方案代码更简洁，不需要处理多范围的返回结构，适合目标列分布比较集中的情况。

最后提醒下：确保你的API权限是正常的（至少要有spreadsheets.readonly权限），如果表格有表头，筛选逻辑和数据行是一样的，不用额外调整。

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