结构修改规则和行为

本部分介绍了使用 Google Docs 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 的边界内。例如，无法在表格的起始索引处插入文本。
  • 图片无法插入到脚注或公式中。
  • 如需了解详情，请参阅插入内嵌图片。

设置文字格式

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

创建段落项目符号

  • 为与指定范围重叠的所有段落创建项目符号。
  • 每个段落的嵌套级别由每个段落前面的前导制表符数量决定。
  • 创建项目符号时，系统会移除前导标签页，这可能会更改部分文本的索引。
  • 如果您添加的段落项目符号与目标段落紧前方的列表项目符号一致，则该段落会加入到列表中。
  • 如需了解详情，请参阅使用列表。

删除文字

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

  • 不允许进行会导致文档结构无效的删除操作。以下是一些无效的删除请求示例：

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

    • 删除 Body、Header、Footer、Footnote、TableCell 或 TableOfContents 的最后一个换行符。

    • 删除 Table、TableOfContents 或 Equation 的开头或结尾，而不删除整个元素。

    • 删除 Table、TableOfContents 或 SectionBreak 前面的换行符，但不删除相应元素。

    • 删除表格中的个别行或单元格。允许删除表格单元格中的内容。

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