如何通过Google Docs API在Python中动态填充表格？

你遇到的错误核心是：直接使用文档全局索引插入文本不可靠。Google Docs的表格单元格内部是独立的段落结构，空单元格本身包含一个空段落，但全局索引会随着你插入新行而发生偏移，而且手动指定的固定索引（比如2580）根本无法精准对应到目标单元格的段落范围内。

不要依赖全局索引定位单元格，改用TableCellLocation明确指定要插入的单元格位置，结合insertText的location参数中的tableCellLocation字段，直接定位到目标单元格的空段落中插入内容。

SCOPES = ['https://www.googleapis.com/auth/drive']
CREDENTIALS = ServiceAccountCredentials.from_json_keyfile_name(os.environ["CREDS"], scopes=SCOPES)
GOOGLE_DOCS_SERVICE = build('docs', 'v1', credentials=CREDENTIALS)
# 模板表格的起始位置索引（你原代码中的2488）
TABLE_START_INDEX = 2488
# 模板表格的表头行索引（假设表头是第0行，第一行空数据行是第1行）
START_DATA_ROW_INDEX = 1

def get_table_requests(fruits):
    requests = []
    # 1. 插入需要的新行：模板已有1行空数据行，需额外插入(len(fruits)-1)行
    for _ in range(len(fruits) - 1):
        requests.append({
            "insertTableRow": {
                "tableCellLocation": {
                    "tableStartLocation": {"index": TABLE_START_INDEX},
                    "rowIndex": START_DATA_ROW_INDEX,
                    "columnIndex": 0  # 列索引只要在表格范围内即可
                },
                "insertBelow": True  # API要求传入布尔值，而非字符串
            }
        })
    
    # 2. 向每个单元格插入文本
    for row_idx, fruit in enumerate(fruits):
        # 当前数据行的索引：起始数据行 + 循环索引
        current_row = START_DATA_ROW_INDEX + row_idx
        # 明确列顺序，确保和表格列对应
        columns = ["name", "description", "stuff"]
        for col_idx, key in enumerate(columns):
            value = fruit[key]
            requests.append({
                "insertText": {
                    "location": {
                        "tableCellLocation": {
                            "tableStartLocation": {"index": TABLE_START_INDEX},
                            "rowIndex": current_row,
                            "columnIndex": col_idx
                        },
                        # 插入到单元格空段落的起始位置
                        "index": 0
                    },
                    "text": value
                }
            })
    
    return requests

def modify_document(new_doc_id):
    fruits = [
        {"name": "apple", "description":"juicy", "stuff": "why not?"},
        {"name": "banana", "description":"healthy", "stuff": "yeah!"}
    ]
    requests = get_table_requests(fruits)
    GOOGLE_DOCS_SERVICE.documents().batchUpdate(
        documentId=new_doc_id,
        body={'requests': requests}
    ).execute()

• 精准定位单元格：通过表格起始位置、行索引、列索引直接锁定目标单元格，不受文档结构变化影响。
• 插入位置合规：每个空单元格默认包含一个空段落，指定index:0就是这个段落的起始位置，符合API要求的“插入到现有段落范围内”。
• 统一列顺序：明确columns列表，确保字典的键和表格列顺序对应，避免数据错位。
• 参数规范：将insertBelow的字符串值改为布尔值True，符合API参数要求。

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