如何通过Google Sheets API为文本设置加粗与高亮格式？

你当前使用的spreadsheets_values->update接口仅能处理单元格值，无法设置样式。要实现加粗、高亮等格式，必须通过spreadsheets->batchUpdate接口修改单元格的样式属性。

核心修改思路 #

1. 记录需要格式化的单元格位置（行+列）
2. 先完成数据写入
3. 批量发送格式更新请求，指定加粗、背景色等样式

修改后的完整代码 #

$service = new \Google_Service_Sheets($client);
$spreadsheetId = 'xxxxxxx';
$spreadsheet = $service->spreadsheets->get($spreadsheetId);
// 获取目标Sheet的ID（取第一个Sheet，如需其他Sheet调整索引）
$sheetId = $spreadsheet->getSheets()[0]->getProperties()->getSheetId();

$result = $db->query("SELECT * from xxxxxx");
$oldref = '1';
if ($result->num_rows > 0) {
    $rows = array();
    $formatRanges = array(); // 存储需设置格式的单元格范围
    $i = 0;
    while ($row = $result->fetch_assoc()) {
        $i++;
        if ($oldref != $row['refnumber']) {
            // 记录单元格：假设写入A列，行号对应循环中的$i
            $formatRanges[] = "Sheet1!A{$i}";
            $newRow = [$row['refnumber']];
            array_push($rows, $newRow);       
            $oldref = $row['refnumber']; // 更新旧编号，避免重复处理
        }
    }

    // 第一步：写入数据到表格
    $valueRange = new \Google_Service_Sheets_ValueRange();
    $valueRange->setValues($rows);
    $range = 'Sheet1';
    $options = ['valueInputOption' => 'USER_ENTERED'];
    $service->spreadsheets_values->update($spreadsheetId, $range, $valueRange, $options);

    // 第二步：批量设置单元格格式
    if (!empty($formatRanges)) {
        $requests = [];
        foreach ($formatRanges as $range) {
            $requests[] = new \Google_Service_Sheets_Request([
                'repeatCell' => [
                    'range' => [
                        'sheetId' => $sheetId,
                        'range' => $range
                    ],
                    'cell' => [
                        'userEnteredFormat' => [
                            'textFormat' => [
                                'bold' => true // 开启文本加粗
                            ],
                            'backgroundColor' => [ // 设置高亮背景色（示例：浅黄色）
                                'red' => 1,
                                'green' => 0.9,
                                'blue' => 0.6
                            ]
                        ]
                    ],
                    'fields' => 'userEnteredFormat(textFormat,backgroundColor)' // 指定要更新的格式字段
                ]
            ]);
        }

        $batchUpdateRequest = new \Google_Service_Sheets_BatchUpdateSpreadsheetRequest([
            'requests' => $requests
        ]);
        $service->spreadsheets->batchUpdate($spreadsheetId, $batchUpdateRequest);
    }
}

关键说明 #

• Sheet ID获取：必须通过$spreadsheet->getSheets()[0]->getProperties()->getSheetId()获取Sheet的唯一ID，仅用名称无法在batchUpdate中准确定位。
• 格式字段控制：fields参数明确指定要更新的格式属性（比如仅更新文本加粗和背景色），避免覆盖单元格原有其他格式。
• 行号对应：如果你的数据是从表头行之后开始写入（比如第二行），需要调整循环中$i的起始值，或者在记录单元格行号时加偏移量（如$i+1）。
• 颜色调整：backgroundColor的RGB值范围为0-1，可根据需求修改为其他颜色（比如红色['red' => 1, 'green' => 0, 'blue' => 0]）。

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