如何使用Google Sheets API v4仅更新指定单元格文本颜色且保留原有格式

问题根源 #

你遇到的问题是Fields参数配置错误导致的全量覆盖：

• 你当前代码中UpdateCellsRequest的Fields设置为"*"，代表覆盖单元格的所有属性，包括单元格值、边框、对齐方式等其他格式，因此原有内容和格式都会被清空
• 你构造的CellData仅设置了文本前景色相关的格式，其余属性均为默认空值，全量覆盖时自然会清空原有数据

解决方案 #

方案1：直接修改现有代码

仅需把Fields的取值从"*"改为要更新的具体字段路径即可，其余代码基本不用调整：

// 只修改这一行即可，字段名要使用小驼峰写法
Fields = "userEnteredFormat.textFormat.foregroundColor",

修改后API只会更新你指定的文本前景色属性，其余所有单元格内容、格式都会保留不变。

方案2：使用更简洁的RepeatCellRequest实现（推荐）

如果要批量修改固定区域的格式，用RepeatCellRequest不需要逐个构造CellData，代码更简洁，也不会影响原有内容：

if (foreColor != System.Drawing.Color.Empty)
{
    var spreadsheet = await service.Spreadsheets.Get(_spreadsheetId).ExecuteAsync();
    var sheet = spreadsheet.Sheets.First(s => s.Properties.Title == worksheetTitle);
    int sheetId = sheet.Properties.SheetId ?? 0;

    var request = new Request
    {
        RepeatCell = new RepeatCellRequest
        {
            Range = new GridRange
            {
                SheetId = sheetId,
                StartRowIndex = rowNumber - 1,
                EndRowIndex = rowNumber, // 只改当前1行
                StartColumnIndex = startColumnIndex,
                EndColumnIndex = startColumnIndex + 6 // 对应示例里需要修改的6个单元格
            },
            Cell = new CellData
            {
                UserEnteredFormat = new CellFormat
                {
                    TextFormat = new TextFormat
                    {
                        ForegroundColor = new Color
                        {
                            Alpha = foreColor.A / 255f,
                            Red = foreColor.R / 255f,
                            Green = foreColor.G / 255f,
                            Blue = foreColor.B / 255f,
                        }
                    }
                }
            },
            // 同样只指定要更新的字段
            Fields = "userEnteredFormat.textFormat.foregroundColor"
        }
    };

    var requests = new BatchUpdateSpreadsheetRequest
    {
        Requests = new List<Request> { request },
    };

    var response = await service.Spreadsheets.BatchUpdate(requests, spreadsheet.SpreadsheetId).ExecuteAsync();
}

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