结构修改规则和行为

本部分介绍了使用 Google 文档 API 编辑文档时必须了解的行为和限制。

通常,您无法执行会导致文档中元素结构无效的修改。请查看每个 documents.batchUpdate 请求方法,了解适用于这些请求的约束和规则。

以下部分总结了这些方法的关键规则。

插入文本

  • 插入换行符会在相应索引处隐式创建一个 Paragraph。新段落的段落样式会从当前插入索引处的段落复制,包括列表和项目符号。
  • 文本必须插入现有 Paragraph 的边界内。例如,无法在表格的起始索引处插入文本。文本必须插入前面的段落中。
  • 该 API 可能会隐式调整位置,以防止在 Unicode 字符图案集群中进行插入。在这种情况下,系统会在字符图谱集群后面立即插入文本。
  • 系统会自动确定插入文本的文本样式,通常会保留相邻文本的样式。通常,插入文本的文本样式与插入索引前面的文本一致。
  • 系统会从插入的文字中剥离某些控制字符 (U+0000-U+0008, U+000C-U+001F) 和 Unicode 基本多语言平面私用区域 (U+E000-U+F8FF) 中的字符。
  • 如需了解详情,请参阅插入、删除和移动文本

插入内嵌图片

  • 图片必须小于 50 MB,不能超过 2500 万像素,并且必须采用 PNG、JPEG 或 GIF 格式。
  • 提供的 URI 必须可公开访问,且长度不得超过 2 KB。
  • 图片必须插入现有 Paragraph 的边界内。例如,无法在表格的起始索引处插入文本。
  • 无法在脚注或公式中插入图片。
  • 如需了解详情,请参阅插入内嵌图片

设置文字格式

  • 当您对某个范围应用段落级格式时,系统会将该格式应用于与该范围部分或完全重叠的任何段落。
  • 可能会扩展该范围,以包含相邻的换行符。
  • 如果范围完全包含属于列表的段落,则段落的项目符号也会更新为匹配的文本样式。
  • 如需了解详情,请参阅设置文本格式

创建段落项目符号

  • 为与给定范围重叠的所有段落创建项目符号。
  • 每个段落的嵌套级别由每个段落前面的前导制表符号数决定。
  • 创建项目符号时,系统会移除前导制表符,这可能会更改文本部分的编号。
  • 如果您在目标段落前面添加与列表中项目符号匹配的段落项目符号,系统会将该段落加入到列表中。
  • 如需了解详情,请参阅使用列表

删除文字

  • 删除跨越段落边界的文本可能会导致段落样式、列表、定位对象和书签发生变化,因为这两个段落会合并。

  • 不允许删除会导致文档结构无效的内容。无效删除请求的一些示例包括:

    • 删除代理对的一个代码单元。

    • 删除 BodyHeaderFooterFootnoteTableCellTableOfContents 的最后一个换行符。

    • 删除 TableTableOfContentsEquation 的开头或结尾,但不删除整个元素。

    • 删除 TableTableOfContentsSectionBreak 前面的换行符,而不删除相应元素。

    • 删除表格的各行或单元格。可以删除表格单元格中的内容。

  • 如需了解详情,请参阅插入、删除和移动文本