本部分介绍了在使用 Google 文档 API 编辑文档时您必须了解的行为和限制。
一般情况下,您无法执行会导致文档中元素结构无效的修改。查看每个 documents.batchUpdate
请求方法,了解适用于这些请求的限制条件和规则。
以下部分总结了这些方法的关键规则。
插入文本
- 插入换行符会隐式在该索引处创建一个
Paragraph
。系统会从当前插入索引处的段落复制新段落的段落样式,包括列表和项目符号。 - 文本必须插入现有
Paragraph
的边界内。例如,无法在表的起始索引处插入文本。文本必须插入上一段落。 - API 可能会隐式调整位置,以防止在 Unicode 字素聚类中插入。如果发生这种情况,文本将立即插入字素聚类之后。
- 插入文本的文本样式由系统自动确定,通常保留相邻文本的样式。通常,插入文本的文本样式与插入索引前面紧邻的文本匹配。
- 系统会从插入的文本中删除 Unicode 基本多语言平面私人使用区域 (
U+E000-U+F8FF
) 中的某些控制字符 (U+0000-U+0008, U+000C-U+001F
) 和字符。 - 如需了解详情,请参阅插入、删除和移动文本。
插入内嵌图片
- 图片大小必须小于 50 MB,不能超过 2500 万像素,并且必须采用 PNG、JPEG 或 GIF 格式之一。
- 提供的 URI 必须可公开访问,且大小不超过 2 KB。
- 图片必须插入现有
Paragraph
的边界内。例如,无法在表的起始索引处插入文本。 - 无法将图片插入到脚注或等式中。
- 如需了解详情,请参阅插入内嵌图片。
设置文字格式
- 当您对某个范围应用段落级别格式时,相应格式会应用于该范围与其部分或完全重叠的任何段落。
- 可能会扩展范围以包含相邻的换行符。
- 如果该范围完全包含属于某个列表的段落,则段落项目符号也会使用匹配的文本样式进行更新。
- 如需了解详情,请参阅设置文本格式。
创建段落项目符号
- 为与指定范围重叠的所有段落创建项目符号。
- 每个段落的嵌套级别由每个段落前面的前置标签页数量决定。
- 创建项目符号时,前导制表符会被移除,这可能会改变文本各部分的索引。
- 如果您在目标段落之前添加的段落项目符号与列表的条目匹配,则段落将联接到列表中。
- 如需了解详情,请参阅使用列表。
删除文字
删除跨越段落边界的文本可能会导致段落样式、列表、定位的对象和书签在两个段落合并时发生变化。
不允许删除操作会导致文档结构无效。无效删除请求的一些示例包括:
删除代理对的一个代码单元。
删除
Body
、Header
、Footer
、Footnote
、TableCell
或TableOfContents
的最后一个换行符。删除
Table
、TableOfContents
或SectionBreak
前面的换行符,而不删除该元素。删除表格中的个别行或单元格。允许删除表单元格中的内容。
如需了解详情,请参阅插入、删除和移动文本。