Python调用Google Docs API复制指定区间任意类型文档内容方法

Google Docs API没有提供原生的跨类型内容块一键复制接口，所有复制逻辑都要基于「提取区间内结构化元素→按规则重建插入」的思路实现——本质上是模拟手动复制粘贴时，编辑器识别内容、重建元素的过程。

实现步骤 #

• 第一步：拉取并筛选目标区间的结构化内容 #

  调用documents.get接口获取目标文档全量内容，不要做字段过滤，避免遗漏图片、表格这类非文本元素的属性。
  遍历返回的body.content节点，筛选出所有startIndex >= 复制起始位置、endIndex <= 复制结束位置的元素。注意文档内容是嵌套结构：表格内部会嵌套行、单元格，单元格里还可能嵌文本、图片甚至子表格，必须递归遍历所有嵌套层级，不能只扫描顶层元素。
  筛选完成后统一修正元素索引：把所有元素的原始全局索引减去复制区间的起始索引，转成相对于待复制内容块起点的相对索引，避免后续插入时位置错乱。

• 第二步：按元素类型映射生成插入请求 #

  不同类型元素要对应匹配API支持的插入/样式更新接口，必须完整提取样式属性，否则复制出来的内容会丢失格式：
  • 文本段落：提取完整文本内容、文本样式（加粗、斜体、颜色、字体、超链接等）、段落样式（对齐、缩进、列表属性、行间距等），对应生成insertText、updateTextStyle、updateParagraphStyle请求。
  • 行内图片：提取图片源地址、尺寸、裁剪属性、文字环绕方式，对应生成insertInlineImage请求，嵌在文本流中的图片要匹配到正确的相对位置插入。
  • 表格：提取表格行列数、单元格合并属性、边框/背景样式、单元格内的嵌套内容，先调用insertTable生成对应规格的空表格，再递归往每个单元格内填充内容、设置样式，处理逻辑和顶层内容完全一致。
  • 特殊元素（分页符、水平线、书签等）：对应匹配insertPageBreak、insertHorizontalRule等专用接口，API暂不支持直接插入的元素要提前做兼容标记。

• 第三步：处理偏移量批量提交请求 #

  初始插入位置设置为原复制区间的结束索引（即原内容块的末尾）。
  核心注意事项：每插入一个元素，后续元素的插入位置要累加当前插入元素占用的索引长度——普通文本按字符数算长度，行内图片、分页符、水平线这类单元素固定占1个索引长度，否则所有内容会堆叠在同一位置。
  把所有请求按插入顺序打包为batchUpdate请求一次性提交，减少接口调用次数，也能避免多次调用带来的索引计算误差。

示例逻辑说明 #

假设你要复制的内容块从"Lorem ipsum"开头到"consectetur adipiscing elit."结尾，对应全局索引10到120，筛选元素时会依次拿到：

1. 索引10-38的首行文本段落
2. 索引39位置的行内图片
3. 索引40-95位置的表格，递归提取所有单元格内容和样式
4. 索引96-120位置的末行文本段落
   把这些元素转成对应插入请求后，从索引120位置开始按顺序插入，每插完一个元素累加对应长度，最终就能得到原内容块完整重复两次的效果，和手动复制粘贴的结果完全一致。

常见踩坑点 #

• 不要直接把接口返回的元素JSON结构直接传入插入请求，API返回的元素结构和写入请求的参数结构、字段名存在差异，直接传会报参数错误。
• 处理嵌套表格、多层列表这类复杂结构时，递归逻辑要加深度终止条件，避免死循环。
• 如果复制区间截断了部分元素（比如从段落中间开始、到另一个段落中间结束），要手动截断对应文本段的内容，不要把区间外的内容带入复制结果。
• 受权限保护的内嵌图片要提前确认调用身份有访问权限，否则插入后会显示无权限占位符。

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