如何用Python获取Google Sheets带条件格式单元格的字体颜色

你之前的代码返回的是整个表格的条件格式规则集合，而非单元格实际生效的格式。要拿到条件格式应用后的字体颜色，需要获取单元格的effectiveFormat——这是Google Sheets计算后最终显示的格式，包含条件格式的叠加效果。

解决方案代码 #

import gspread
from googleapiclient.discovery import build

# 初始化gspread客户端
client = gspread.service_account_from_dict(creds)
spreadsheet_id = '1qlfDoQctCjfsO-bJkNbedi4t9P_8Uq242WxiOabZSA4'
rng = "WH Data!H2"  # 目标单元格的A1格式

# 构建Sheets API v4服务
service = build("sheets", "v4", credentials=client.auth)

# 请求单元格的effectiveFormat（生效格式）
res = service.spreadsheets().get(
    spreadsheetId=spreadsheet_id,
    ranges=[rng],
    fields="sheets(data(rowData(values(effectiveFormat(textFormat(foregroundColor)))))"
).execute()

# 解析返回结果，提取字体颜色
try:
    color = res["sheets"][0]["data"][0]["rowData"][0]["values"][0]["effectiveFormat"]["textFormat"]["foregroundColor"]
    print(f"字体颜色RGB: 红={color['red']}, 绿={color['green']}, 蓝={color['blue']}")
except KeyError:
    print("该单元格未设置自定义字体颜色，使用表格默认格式")

关键说明 #

• effectiveFormat：区别于userEnteredFormat（用户手动设置的基础格式），它会自动计算条件格式、数据验证等规则后的最终显示格式，正是你需要的实际字体颜色。
• 字段参数fields精确指定路径，避免返回冗余数据，提升请求效率。
• 异常处理：如果单元格没有自定义字体颜色（包括条件格式未触发的情况），会抛出KeyError，此时使用表格默认字体颜色。

补充：验证条件格式触发状态 #

如果需要确认单元格是否触发了某条条件格式规则，可以结合之前获取的conditionalFormats，对比单元格值和规则的条件判断是否应用了对应格式，但实际显示的颜色仍以effectiveFormat为准。

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