结构修改规则和行为

本部分介绍了在以下情况中必须了解的行为和限制： 使用 Google 文档 API 编辑文档。

一般来说，您不能执行会导致 多个元素。查看每个 documents.batchUpdate request 方法，了解适用于这些对象的限制条件和规则 请求。

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

插入文本

  • 插入换行符会隐式创建一个 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 的边界内。对于 例如，不能在表的起始索引处插入文本。
  • 不能将图片插入脚注或等式中。
  • 如需了解详情，请参阅插入内嵌图片。

设置文字格式

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

创建段落项目符号

  • 为与指定范围重叠的所有段落创建项目符号。
  • 每个段落的嵌套级别由前导序号数决定， 每个段落前制表符。
  • 创建项目符号时，前导标签页会被移除，但这些内容可能会发生变化 文本部分的索引。
  • 如果您添加的段落项目符号与前面紧挨列表的内容相匹配 目标段落，则该段落会加入列表。
  • 如需了解详情，请参阅使用列表。

删除文字

  • 删除跨越段落边界的文本可能会导致 段落样式、列表、定位对象和书签 会合并段落。

  • 不允许导致文档结构无效的删除操作。部分 无效删除请求的示例包括：

  • 有关详情，请参阅插入、删除和移动 文本。