Google Docs API批量更新JSON payload报错：未知字段columnProperties

核心错误原因 #

你遇到的400错误是因为Google Docs API的updateTableColumnProperties请求字段名错误：API要求的字段是tableColumnProperties，但你的代码里写的是columnProperties，这直接导致API无法识别请求参数。

关键修复步骤 #

1. 修正列属性更新请求 #

把requests里的columnProperties替换为tableColumnProperties，同时同步更新fields参数：

requests = [
  {
    'updateTableColumnProperties': {
      'tableStartLocation': {
        'index': table_index
      },
      'columnIndices': [column_index],
      # 修正字段名
      'tableColumnProperties': {
        'width': {
          'magnitude': 200,
          'unit': 'PT'
        }
      },
      # 同步修改fields参数
      'fields': 'tableColumnProperties.width'
    }
  }
]

2. 修复表格内容更新逻辑 #

你之前直接修改本地row['tableCells']的操作是无效的——这只是修改了内存中的对象，不会同步到Google Docs。需要通过batchUpdate的insertText和deleteContentRange请求来实际写入翻译内容：

# 替换原有的单元格修改代码
if translation:
    # 处理第三列单元格
    target_cell = cells[column_index + 1] if len(cells) > column_index + 1 else None
    if target_cell:
        # 清空原有内容并插入翻译文本
        start_idx = target_cell['startIndex']
        end_idx = target_cell['endIndex']
        # 先删除原有内容
        requests.append({
            'deleteContentRange': {
                'range': {
                    'startIndex': start_idx,
                    'endIndex': end_idx - 1  # 保留单元格的结束标记
                }
            }
        })
        # 插入翻译内容
        requests.append({
            'insertText': {
                'location': {
                    'index': start_idx
                },
                'text': translation
            }
        })
    else:
        # 如果第三列不存在，先插入新列
        requests.append({
            'insertTableColumn': {
                'tableStartLocation': {
                    'index': table_index
                },
                'columnIndex': column_index + 1
            }
        })

3. 移除重复代码 #

你的代码里有两段完全重复的第三列单元格处理逻辑，删掉其中一段即可：

# 删除这段重复代码
cell = cells[column_index + 1] if len(cells) > column_index + 1 else None
if cell:
    cell['content'] = [new_cell]
else:
    row['tableCells'].append({'content': [new_cell]})

修改后的完整关键代码片段 #

# 替换原有的表格循环内代码
for table in tables:
    column_index = 1
    rows = table.get('tableRows', [])
    requests = []  # 初始化请求列表，统一批量提交
    table_start_loc = {'index': table_index}
    
    # 先添加列宽调整请求（可选）
    requests.append({
        'updateTableColumnProperties': {
            'tableStartLocation': table_start_loc,
            'columnIndices': [column_index],
            'tableColumnProperties': {
                'width': {'magnitude': 200, 'unit': 'PT'}
            },
            'fields': 'tableColumnProperties.width'
        }
    })
    
    for row in rows:
        cells = row.get('tableCells', [])
        cell = cells[column_index] if len(cells) > column_index else None
        if cell:
            text = cell.get('content', [{}])[0].get('paragraph', {}).get('elements', [{}])[0].get('textRun', {}).get('content', '').strip()
            if text:
                try:
                    response = translate.translate_text(Text=text, SourceLanguageCode='auto', TargetLanguageCode=target_lang_code)
                    translation = response['TranslatedText']
                except Exception as e:
                    print(f"翻译'{text}'出错: {e}")
                    continue
                
                # 处理第三列内容
                if len(cells) > column_index + 1:
                    # 第三列已存在，更新内容
                    target_cell = cells[column_index + 1]
                    start_idx = target_cell['startIndex']
                    end_idx = target_cell['endIndex']
                    requests.append({
                        'deleteContentRange': {'range': {'startIndex': start_idx, 'endIndex': end_idx -1}}
                    })
                    requests.append({
                        'insertText': {'location': {'index': start_idx}, 'text': translation}
                    })
                else:
                    # 第三列不存在，插入新列
                    requests.append({
                        'insertTableColumn': {
                            'tableStartLocation': table_start_loc,
                            'columnIndex': column_index +1
                        }
                    })
    
    # 统一提交所有请求
    if requests:
        try:
            response = service.documents().batchUpdate(documentId=doc_id, body={'requests': requests}).execute()
            print('翻译完成。')
        except HttpError as error:
            print(f'请求出错: {error}')

额外提示 #

• Google Docs API建议一次性提交所有批量操作，减少API调用次数
• 插入列后文档的全局索引会变化，建议先完成所有列的插入操作，再进行翻译内容的写入，避免索引偏移
• 处理表格时，注意单元格的startIndex和endIndex是文档全局索引，不是表格内的局部索引

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