如何使用Google Sheets API按名称升序排序数据并校验请求参数

一、现有代码存在的错误 #

你当前传入的$requestBody对象和参数都存在多处错误：

• 接口选择错误：Google_Service_Sheets_BatchUpdateValuesRequest和spreadsheets_values->batchUpdate接口仅用于批量修改单元格数值，排序属于表格结构编辑操作，应该使用Google_Service_Sheets_BatchUpdateSpreadsheetRequest对象，调用spreadsheets->batchUpdate接口。
• 列索引错误：Google Sheets的列索引dimensionIndex从0开始计数，你的name列是第一列（对应A列），索引应为0，你填写的1实际对应的是day列。
• 筛选条件多余且错误：你添加的criteria规则会筛选出单元格值等于name的行，最终只会保留表头行，完全不符合你的需求。
• 排序参数结构错误：sortSpecs需要是数组包裹的对象格式，你当前少了一层数组嵌套。

二、addFilterView和setBasicFilter的选择 #

两个都不是纯排序需求的最优选择，二者的适用场景如下：

• setBasicFilter：设置表格全局可见的基础筛选器，修改后所有访问表格的用户都会看到该筛选排序状态，会覆盖之前的全局筛选设置。
• addFilterView：创建独立保存的筛选视图，不会影响其他用户的默认视图，可后续重复调用该视图配置。
  如果你的需求只是对表格数据进行排序并获取结果，不需要保留筛选配置，更推荐直接使用sortRange请求，它可以直接对指定范围的数据按规则排序，没有多余的筛选相关逻辑。

三、正确实现方案 #

方案1：不修改原表格，直接拉取数据后本地排序（最简便） #

如果不需要修改原表格的排序状态，直接拉取数据后在代码中排序即可：

public function GetSortedValue()
{
    $service = new \Google_Service_Sheets($this->ClientAuth());
    // 替换为你的数据范围，比如Sheet1!A2:C就是跳过表头的所有数据行
    $range = 'Sheet1!A2:C';
    $response = $service->spreadsheets_values->get($this->spreadsheetID, $range);
    $values = $response->getValues();

    // 按第一列（name）升序排序
    usort($values, function($a, $b) {
        return strcmp($a[0], $b[0]);
    });

    // 这里的$values就是排序后的结果
    return $values;
}

方案2：需要修改原表格的排序状态，使用sortRange请求 #

public function SortAndGetValue()
{
    $data = [
        'requests' => [
            [
                'sortRange' => [
                    'range' => [
                        // 替换为你的工作表ID
                        'sheetId' => 0,
                        // 排序范围，从第1行（跳过表头）到最后一行，0列到2列对应A到C列
                        'startRowIndex' => 1,
                        'startColumnIndex' => 0,
                        'endColumnIndex' => 3
                    ],
                    'sortSpecs' => [
                        [
                            'dimensionIndex' => 0, // name列对应的索引
                            'sortOrder' => 'ASCENDING'
                        ]
                    ]
                ]
            ]
        ]
    ];

    $service = new \Google_Service_Sheets($this->ClientAuth());
    $requestBody = new \Google_Service_Sheets_BatchUpdateSpreadsheetRequest($data);
    $service->spreadsheets->batchUpdate($this->spreadsheetID, $requestBody);

    // 排序完成后拉取数据即可
    $range = 'Sheet1!A2:C';
    $response = $service->spreadsheets_values->get($this->spreadsheetID, $range);
    return $response->getValues();
}

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