使用Google Sheets API v4创建表格时默认样式属性不生效求助

通过Google Sheets API创建表格时，设置了defaultFormat属性（包括对齐方式、换行策略、字体、边框等），但新建的表格仅保留标题、行数和列数，样式设置完全不生效。使用的代码如下：

# Spreadsheet body
sheet_body = {
    'properties': {
        'title': 'Test_Spreadsheet',
        'defaultFormat': {
            'horizontalAlignment': 'CENTER',
            'verticalAlignment': 'MIDDLE',
            'wrapStrategy': 'WRAP',
            'textFormat': {
                'fontFamily': 'calibri',
                'fontSize': 14,
                'bold': True
            },
            'borders': {
                'top': {'style': 'SOLID', 'width': 1},
                'right': {'style': 'SOLID', 'width': 1},
                'bottom': {'style': 'SOLID', 'width': 1},
                'left': {'style': 'SOLID', 'width': 1}
            }
        }
    },
    'sheets': [ {
        'properties': {
            'title': 'Total',
            'gridProperties': {
                'rowCount': 5,
                'columnCount': 3
            }
        } ]
    }
}

# Create spreadsheet
sheet = service.spreadsheets().create(body=sheet_body).execute()

问题原因 #

spreadsheet.properties.defaultFormat仅针对后续新增的单元格生效，创建工作表时默认生成的初始单元格不会自动继承这个格式。

解决方案 #

创建表格后，通过spreadsheets.batchUpdate接口，使用RepeatCell请求将目标格式批量应用到整个工作表的单元格范围。

修改后的完整代码：

# Spreadsheet body
sheet_body = {
    'properties': {
        'title': 'Test_Spreadsheet',
        # 该配置会作用于后续新增的单元格
        'defaultFormat': {
            'horizontalAlignment': 'CENTER',
            'verticalAlignment': 'MIDDLE',
            'wrapStrategy': 'WRAP',
            'textFormat': {
                'fontFamily': 'calibri',
                'fontSize': 14,
                'bold': True
            },
            'borders': {
                'top': {'style': 'SOLID', 'width': 1},
                'right': {'style': 'SOLID', 'width': 1},
                'bottom': {'style': 'SOLID', 'width': 1},
                'left': {'style': 'SOLID', 'width': 1}
            }
        }
    },
    'sheets': [ {
        'properties': {
            'title': 'Total',
            'gridProperties': {
                'rowCount': 5,
                'columnCount': 3
            }
        } ]
    }
}

# Create spreadsheet
sheet = service.spreadsheets().create(body=sheet_body).execute()
spreadsheet_id = sheet['spreadsheetId']
sheet_id = sheet['sheets'][0]['properties']['sheetId']

# 构建批量更新请求，应用格式到整个工作表范围
batch_update_body = {
    'requests': [
        {
            'repeatCell': {
                'range': {
                    'sheetId': sheet_id,
                    'startRowIndex': 0,
                    'endRowIndex': 5,
                    'startColumnIndex': 0,
                    'endColumnIndex': 3
                },
                'cell': {
                    'userEnteredFormat': {
                        'horizontalAlignment': 'CENTER',
                        'verticalAlignment': 'MIDDLE',
                        'wrapStrategy': 'WRAP',
                        'textFormat': {
                            'fontFamily': 'calibri',
                            'fontSize': 14,
                            'bold': True
                        },
                        'borders': {
                            'top': {'style': 'SOLID', 'width': 1},
                            'right': {'style': 'SOLID', 'width': 1},
                            'bottom': {'style': 'SOLID', 'width': 1},
                            'left': {'style': 'SOLID', 'width': 1}
                        }
                    }
                },
                'fields': 'userEnteredFormat(horizontalAlignment,verticalAlignment,wrapStrategy,textFormat,borders)'
            }
        }
    ]
}

# 执行批量更新
service.spreadsheets().batchUpdate(spreadsheetId=spreadsheet_id, body=batch_update_body).execute()

关键说明 #

• RepeatCell请求可高效将同一格式应用到指定范围的所有单元格
• fields参数精准指定要更新的格式属性，避免覆盖其他未配置的单元格属性
• 表格创建时的defaultFormat依然保留，后续新增的单元格会自动继承该样式

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