基于Python SDK程序化构建完整表格的高效实现问题

我太懂你这种想高效搭建层级表格的纠结了——先建父行、再查ID、接着建子行的分步操作不仅繁琐，还会因为多次调用API拖慢整体效率。这里给你一套批量优先的解决方案，只需要两次核心API调用就能搞定：

核心思路 #

先一次性批量创建所有行（包括父行和子行），等所有行都生成唯一ID后，再批量更新子行的parent_id属性来建立层级关系。这样就不用在创建过程中反复查询或等待，效率拉满。

步骤1：准备带关联标记的行数据 #

给每一行数据加一个自定义的关联标记（比如parent_key），用来标识它属于哪个父行，不需要依赖还未生成的行ID。举个例子：

# 准备所有要创建的行，用parent_key标记父子关联
rows_to_create = [
    {"cells": {"任务名称": "项目启动"}, "parent_key": "task_launch"},
    {"cells": {"任务名称": "确定需求"}, "parent_key": "task_launch"},
    {"cells": {"任务名称": "组建团队"}, "parent_key": "task_launch"},
    {"cells": {"任务名称": "项目执行"}, "parent_key": "task_execute"},
    {"cells": {"任务名称": "开发功能"}, "parent_key": "task_execute"},
    {"cells": {"任务名称": "测试验证"}, "parent_key": "task_execute"},
]

注：如果你的表格API不允许创建时添加自定义字段，可以把parent_key暂时存在某个隐藏列里，后续再处理。

步骤2：批量创建所有行，获取带ID的行对象 #

调用add_rows()一次性创建所有行，返回的结果里每一行都会带上系统生成的唯一ID：

# 批量创建所有行
created_rows = sheet.add_rows(rows_to_create)

步骤3：建立关联标记到父行ID的映射 #

遍历创建后的行列表，把父行的关联标记和对应的ID存成字典，方便后续快速查找：

# 构建parent_key到父行ID的映射字典
parent_key_to_id = {}
for row in created_rows:
    # 根据你实际的标记规则判断父行（这里假设parent_key以"task_"开头的是父行）
    parent_key = row.get("parent_key")
    if parent_key and parent_key.startswith("task_"):
        parent_key_to_id[parent_key] = row.id

步骤4：批量准备子行的更新数据 #

再次遍历行列表，找出所有子行，通过关联标记匹配到对应的父行ID，准备好批量更新的数据：

# 收集需要更新parent_id的子行数据
rows_to_update = []
for row in created_rows:
    parent_key = row.get("parent_key")
    # 判断当前行是子行（关联标记存在于映射字典，且自身不是父行）
    if parent_key in parent_key_to_id and row.id != parent_key_to_id[parent_key]:
        rows_to_update.append({
            "id": row.id,
            "parent_id": parent_key_to_id[parent_key]
        })

步骤5：批量更新子行的层级关系 #

最后调用update_rows()一次性完成所有子行的parent_id设置，直接建立父子层级：

# 批量更新子行的parent_id
if rows_to_update:
    sheet.update_rows(rows_to_update)

额外优化建议 #

• 如果担心创建和更新之间有其他行插入影响顺序，批量创建时可以指定插入位置（比如insert_after某个固定行），确保行的顺序和你预设的一致。
• 部分表格API支持通过indent属性直接设置缩进层级，如果你的需求只是简单的层级缩进，也可以在批量更新时直接设置indent值（比如子行设为1，孙行设为2等），效果和设置parent_id一致。

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