Google Sheets Python API：repeatCell请求返回200但格式未生效

核心问题 #

你的请求中repeatCell的目标范围是空的，导致API执行后没有修改任何单元格，因此返回的replies为空数组，格式自然无法应用到表格。

问题原因 #

Google Sheets API的范围采用左闭右开规则（即[start, end)），当startRowIndex等于endRowIndex，或startColumnIndex等于endColumnIndex时，该范围不包含任何单元格。

从你的请求体可以看到：

'range': {
    'endColumnIndex': 3,
    'endRowIndex': 3,
    'startColumnIndex': 3,
    'startRowIndex': 3
}

行和列的起始、结束索引完全相同，范围为空。

这个错误来自get_format_request函数的索引计算逻辑：

• 你将传入的start_row_idx和start_col_idx都加了1（startRowIndex = start_row_idx+1）
• 但结束索引只做了start_row_idx + ver_count的计算，没有同步加1

以你调用时的参数为例：start_row_idx=2，ver_count=1，计算后startRowIndex=3，endRowIndex=2+1=3，行范围为空。

解决方案 #

调整get_format_request中的范围计算逻辑，确保范围包含目标单元格：

方案1：去掉起始索引的+1（假设传入的是0-based索引） #

request = {
    'repeatCell': {
        'range': {
            'sheetId': self.get_sid(ssid, sheet_name),
            'startRowIndex': start_row_idx,  # 移除+1
            'startColumnIndex': start_col_idx,  # 移除+1
            'endRowIndex': start_row_idx + ver_count,
            'endColumnIndex': start_col_idx + hor_count
        },
        'fields': f'userEnteredFormat.{mode}'
    }
}

方案2：同步调整结束索引（如果必须保留起始索引+1） #

request = {
    'repeatCell': {
        'range': {
            'sheetId': self.get_sid(ssid, sheet_name),
            'startRowIndex': start_row_idx+1,
            'startColumnIndex': start_col_idx+1,
            'endRowIndex': start_row_idx + 1 + ver_count,  # 增加+1
            'endColumnIndex': start_col_idx + 1 + hor_count  # 增加+1
        },
        'fields': f'userEnteredFormat.{mode}'
    }
}

补充说明 #

API返回200是因为请求格式合法，只是没有找到可修改的单元格。replies为空是这种场景下的正常返回，并非API错误。

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