如何在Google Slides API中仅替换TextRun内的文本？

嘿，这个场景我太熟了！之前帮客户做每日自动更新Slides表格的需求时，也踩过固定索引的坑——内容一换，索引全乱，样式直接跑偏。给你一套基于TextRun长度的可靠方案，完全避开固定索引的问题：

不依赖固定的起止索引，而是先捕获现有每行的样式，再清空单元格后重新插入带对应样式的新内容，全程用内容长度计算位置，绝对不会因为内容长短变化失效。

1. 获取目标单元格的现有文本样式 #

首先得拿到单元格里三行文本各自的格式，这样更新内容时能保留原有样式：

# 假设已初始化好Slides API的service实例
presentation_id = "你的演示文稿ID"
slide_id = "目标幻灯片的ID"
table_id = "目标表格的ID"
target_row = 0  # 要更新的单元格行号
target_col = 0  # 要更新的单元格列号

# 获取单元格的文本元素结构
response = slides_service.presentations().get(
    presentationId=presentation_id,
    fields="slides/elements/table/tableRows/tableCells/textContent"
).execute()

# 定位到目标单元格
target_cell = None
for slide in response["slides"]:
    if slide["objectId"] != slide_id:
        continue
    for elem in slide["elements"]:
        if not elem.get("table") or elem["table"]["objectId"] != table_id:
            continue
        for row_idx, row in enumerate(elem["table"]["tableRows"]):
            if row_idx != target_row:
                continue
            for col_idx, cell in enumerate(row["tableCells"]):
                if col_idx == target_col:
                    target_cell = cell
                    break
            if target_cell:
                break
    if target_cell:
        break

# 筛选出有效内容的TextRun（跳过空行和换行符）
content_runs = []
for text_elem in target_cell["textContent"]["textElements"]:
    if "textRun" in text_elem and text_elem["textRun"]["content"].strip():
        content_runs.append(text_elem["textRun"])

# 提取三行对应的样式（如果是首次初始化，可手动设置默认样式）
if len(content_runs) == 3:
    line_styles = [run["style"] for run in content_runs]
else:
    # 首次没有内容时，手动定义三行的默认样式
    line_styles = [
        {"fontSize": {"magnitude": 18, "unit": "PT"}},  # 第一行大字号
        {"fontSize": {"magnitude": 12, "unit": "PT"}, "foregroundColor": {"opaqueColor": {"rgbColor": {"green": 1.0}}}},  # 第二行绿色小字号
        {"fontSize": {"magnitude": 14, "unit": "PT"}}  # 第三行默认字号
    ]

2. 构建批量更新请求 #

清空单元格后，按内容长度计算位置，插入新内容并应用样式：

# 准备要更新的三行新内容
new_content = [
    "2024-05-20 日活跃用户",
    "12,345",
    "环比增长 5.2%"
]

requests = []

# 第一步：清空单元格所有文本
requests.append({
    "deleteText": {
        "objectId": table_id,
        "textRange": {"type": "ALL"}
    }
})

current_index = 0
for idx, (text, style) in enumerate(zip(new_content, line_styles)):
    # 插入当前行的文本
    requests.append({
        "insertText": {
            "objectId": table_id,
            "location": {"index": current_index},
            "text": text
        }
    })
    # 应用对应样式到当前行文本范围
    requests.append({
        "updateTextStyle": {
            "objectId": table_id,
            "textRange": {
                "startIndex": current_index,
                "endIndex": current_index + len(text)
            },
            "style": style,
            "fields": "*"  # 应用所有样式属性，也可指定具体字段如"fontSize,foregroundColor"
        }
    })
    # 更新索引：加上当前文本长度+换行符长度（1），最后一行不需要换行
    if idx != len(new_content) - 1:
        current_index += len(text) + 1
        # 插入换行符
        requests.append({
            "insertText": {
                "objectId": table_id,
                "location": {"index": current_index - 1},  # 插在当前文本末尾
                "text": "\n"
            }
        })

# 执行批量更新
slides_service.presentations().batchUpdate(
    presentationId=presentation_id,
    body={"requests": requests}
).execute()

• 换行符处理：Slides中换行符长度为1，最后一行不需要插入换行，避免单元格末尾多出空行。
• 样式字段控制：如果不需要保留所有原有样式，可把fields设为具体属性（比如"fontSize,foregroundColor"），减少不必要的样式覆盖。
• 容错机制：如果单元格初始没有内容，提前定义好默认样式，避免报错。

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