如何通过Python调用Google Sheets API设置列的数字格式

我之前也踩过一模一样的坑——背景色能正常生效，但数字格式死活不生效，后来才发现是请求参数的结构和格式类型没写对。要实现和GUI里「格式→数字→数字」完全一致的效果，你得用Sheets API的batchUpdate方法，并且正确配置数字格式的核心参数。

问题核心原因 #

你之前的代码大概率只处理了背景色的设置，而数字格式的numberFormat参数要么没指定正确的type，要么请求的fields范围不对，导致格式设置没被API正确识别应用。

完整的Python代码示例 #

下面是能同时设置列背景色和数字格式的代码，你可以直接替换成自己的表格ID和目标列：

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials

# 加载授权凭证（假设你已经完成OAuth2授权，token.json是生成的授权文件）
creds = Credentials.from_authorized_user_file('token.json', ['https://www.googleapis.com/auth/spreadsheets'])
service = build('sheets', 'v4', credentials=creds)

# 配置你的表格信息
spreadsheet_id = '你的Google表格ID'
target_sheet_id = 0  # 第一个工作表的ID，不确定的话可以通过API获取工作表列表查询
target_column_start = 1  # B列的起始索引（A列是0，以此类推）
target_column_end = 2    # 结束索引，代表只覆盖目标列（比如B列就是1到2）

# 构造批量更新请求
requests = [
    # 1. 设置数字格式（对应GUI的「格式→数字→数字」）
    {
        'repeatCell': {
            'range': {
                'sheetId': target_sheet_id,
                'startColumnIndex': target_column_start,
                'endColumnIndex': target_column_end
            },
            'cell': {
                'userEnteredFormat': {
                    'numberFormat': {
                        'type': 'NUMBER',
                        'pattern': '#,##0.00'  # 自定义数字显示格式，改成'0'就是纯整数格式
                    }
                }
            },
            'fields': 'userEnteredFormat.numberFormat'  # 只更新数字格式，不影响其他已设置的格式
        }
    },
    # 2. 设置列背景色（保留你原来的逻辑）
    {
        'repeatCell': {
            'range': {
                'sheetId': target_sheet_id,
                'startColumnIndex': target_column_start,
                'endColumnIndex': target_column_end
            },
            'cell': {
                'userEnteredFormat': {
                    'backgroundColor': {
                        'red': 0.8,
                        'green': 0.9,
                        'blue': 1.0
                    }
                }
            },
            'fields': 'userEnteredFormat.backgroundColor'
        }
    }
]

# 发送更新请求
response = service.spreadsheets().batchUpdate(
    spreadsheetId=spreadsheet_id,
    body={'requests': requests}
).execute()

print(f"更新成功！共修改了{response['totalUpdatedCells']}个单元格")

关键注意点 #

• numberFormat的type必须设为'NUMBER'：这是对应GUI里的「数字」选项，其他类型比如'CURRENCY'是货币格式、'DATE'是日期格式，别写错了。
• fields参数要精准：比如'userEnteredFormat.numberFormat'表示只更新数字格式，不会覆盖你之前设置的背景色或者其他格式。
• 如果单元格内容是文本形式的数字：比如单元格里是带单引号开头的'123'，设置格式后可能还是显示文本，这时候需要额外添加一个请求把文本转成数值。可以在requests里加一个updateCells请求，把单元格值的userEnteredValue设为数字类型。

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