Google Docs API批量更新同一模板：多组数据重复填充如何实现？

核心原因 #

Google Docs原生没有内置Jinja风格的循环模板逻辑，replaceAllText方法会一次性替换文档内所有匹配的占位符，替换完成后占位符就消失了，所以多次循环调用也找不到可替换的标签。

可行实现方案 #

这里提供两种常用的实现方式，可根据你的格式需求选择： #

方案1：纯文本批量生成（无复杂格式需求时优先选）

不需要提前在模板里放多条占位符，直接在Python端拼接完所有内容后一次性插入文档即可，代码量最少。
实现步骤：

1. 遍历JSON的basket数组，把所有条目的内容按模板格式拼接成完整字符串
2. 把拼接好的内容直接插入到文档的目标位置（可替换你提前预留的单个占位符，也可直接插入文档首尾）
   示例代码：

def update_batch_doc(food_json, docs):
    doc_id = 'xxxxxxxxxxxxx'
    # 拼接所有条目内容
    full_content = ""
    for item in food_json['basket']:
        full_content += f"I went to the shop and bought the following item: {item['food']}. \nIt cost {item['price']} cents.\n\n"
    
    requests = [
        # 先替换掉你提前在模板里留的{{ALL_ITEMS}}占位符，也可以直接指定位置插入
        {
            'replaceAllText': {
                'containsText': {
                    'text': '{{ALL_ITEMS}}',
                    'matchCase': True
                },
                'replaceText': full_content
            }
        }
    ]
    result = docs.documents().batchUpdate(documentId=doc_id, body={'requests': requests}).execute()
    return result

方案2：模板段复制替换（需要保留字体/行距等格式时用）

如果单条内容有固定的排版格式，用这个方法可以完整保留模板的格式。
实现步骤：

1. 先在你的Google Doc模板里，给单条内容的前后加上包裹标记，比如开头加{{ITEM_START}}，结尾加{{ITEM_END}}
2. 先调用documents().get()接口读取文档内容，定位到包裹标记之间的模板段的起始、结束索引，以及模板段的原始内容
3. 遍历basket数组，每一条数据都先复制原始模板段，替换其中的{{foodtype}}和{{price}}占位符，再把替换后的内容插入到文档中
4. 所有条目插入完成后，删除最开始的原始模板段和包裹标记即可
   示例代码核心片段：

# 1. 先获取模板段位置
doc = docs.documents().get(documentId=doc_id).execute()
content = doc.get('body').get('content')
start_idx = None
end_idx = None
template_text = ""

for elem in content:
    if 'paragraph' in elem:
        para_text = ''.join([run.get('textRun', {}).get('content', '') for run in elem['paragraph']['elements']])
        if '{{ITEM_START}}' in para_text:
            start_idx = elem['startIndex']
        if '{{ITEM_END}}' in para_text:
            end_idx = elem['endIndex']
        if start_idx and not end_idx:
            template_text += para_text

# 2. 生成替换后的所有内容
full_content = ""
for item in food_json['basket']:
    item_content = template_text.replace('{{foodtype}}', item['food']).replace('{{price}}', item['price'])
    full_content += item_content

# 3. 先删除原始模板段，再插入新内容
requests = [
    {'deleteContentRange': {'range': {'startIndex': start_idx, 'endIndex': end_idx}}},
    {'insertText': {'location': {'index': start_idx}, 'text': full_content}}
]
docs.documents().batchUpdate(documentId=doc_id, body={'requests': requests}).execute()

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