如何使用Python的gspread获取Google Sheet单元格颜色并应用到其他单元格

核心方法说明 #

gspread-formatting 提供了get_range_formatting接口读取单元格格式（含背景色），配合format_cell_range就能实现颜色复制。以下是具体实现步骤：

1. 安装依赖 #

确保已安装所需库：

pip install gspread gspread-formatting

2. 完整代码示例 #

import gspread
from oauth2client.service_account import ServiceAccountCredentials
from gspread_formatting import get_range_formatting, format_cell_range, CellFormat, Color

# 认证并连接Google Sheet
scope = ["https://spreadsheets.google.com/feeds", "https://www.googleapis.com/auth/drive"]
creds = ServiceAccountCredentials.from_json_keyfile_name("你的服务账号密钥文件.json", scope)
client = gspread.authorize(creds)

# 打开目标表格和工作表
spreadsheet = client.open("你的表格名称")
worksheet = spreadsheet.worksheet("目标工作表名称")

# 提取源单元格的背景色（以A1为例）
source_format = get_range_formatting(worksheet, "A1:A1")[0][0]
source_color = source_format.backgroundColor

# 将颜色应用到目标单元格（以B1为例）
target_format = CellFormat(backgroundColor=Color(
    red=source_color.red,
    green=source_color.green,
    blue=source_color.blue,
    alpha=source_color.alpha  # 透明度参数，可选
))

format_cell_range(worksheet, "B1:B1", target_format)

关键细节说明 #

• get_range_formatting返回二维数组，对应指定的单元格范围，单个单元格需取[0][0]
• 颜色对象Color的red/green/blue/alpha属性取值范围为0-1的浮点数
• 若需复制字体颜色，只需将backgroundColor替换为textFormat.foregroundColor

特殊情况处理 #

如果源单元格颜色来自条件格式规则，get_range_formatting无法直接读取实际显示颜色，此时需结合gspread的client.request方法调用Google Sheets API的spreadsheets.get接口，指定fields参数获取条件格式应用后的实际格式。

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