本節說明使用 Google 文件 API 編輯文件時，必須瞭解的行為和限制。
一般來說，您無法執行會導致文件中元素結構無效的編輯作業。請查看每個 documents.batchUpdate 要求方法，瞭解適用於這些要求的限制和規則。
以下各節將概述這些方法的重要規則。
插入文字
- 插入換行字元會在該索引處隱含建立
Paragraph。新段落的段落樣式會從目前插入索引的段落複製，包括清單和項目符號。 - 文字必須插入現有
Paragraph的邊界內。例如，系統無法將文字插入資料表的起始索引。文字必須插入前一個段落。 - API 可能會隱含調整位置，以防止在萬國碼字符叢集中插入內容。在這種情況下，系統會立即在構詞單元叢集後插入文字。
- 系統會自動決定插入文字的文字樣式，通常會保留相鄰文字的樣式。插入文字的文字樣式通常會與插入索引前方的文字相符。
- 系統會從插入的文字中移除部分控制字元 (
U+0000-U+0008, U+000C-U+001F) 和 Unicode 基本多語言字面私用區 (U+E000-U+F8FF) 中的字元。 - 詳情請參閱「插入、刪除及移動文字」。
插入內嵌圖片
- 圖片大小不得超過 50 MB，且不得超過 2,500 萬像素，格式必須是 PNG、JPEG 或 GIF。
- 提供的 URI 必須可供所有人存取，且長度不得超過 2 KB。
- 圖片必須插入現有
Paragraph的邊界內。舉例來說，無法在表格的起始索引處插入文字。 - 無法在註腳或方程式中插入圖片。
- 詳情請參閱「插入內嵌圖片」。
設定文字格式
- 將段落層級格式套用至範圍時，系統會將格式套用至與該範圍部分或完全重疊的任何段落。
- 範圍可能會延伸，以納入相鄰的換行符號。
- 如果範圍完全包含屬於清單的段落，段落的項目符號也會更新為相符的文字樣式。
- 詳情請參閱「設定文字格式」。
建立段落項目符號
- 為與指定範圍重疊的所有段落建立項目符號。
- 每個段落的巢狀層級取決於每個段落前面的前置空格數量。
- 建立項目符號時，系統會移除開頭的分頁，這可能會變更文字中特定部分的索引。
- 如果您加入的段落項目符號，與清單的項目符號相符，則緊接在目標段落之前，該段落就會加入清單。
- 詳情請參閱使用清單。
刪除文字
如果刪除跨段落邊界的文字，可能會因兩個段落合併而變更段落樣式、清單、定位物件和書籤。
刪除操作不得導致無效的文件結構。以下列舉一些無效的刪除要求範例：
刪除代理值組的一個代碼單位。
刪除
Body、Header、Footer、Footnote、TableCell或TableOfContents的最後一個換行字元。刪除
Table、TableOfContents或SectionBreak前的新行字元，但不刪除元素。刪除資料表中的個別資料列或儲存格。允許刪除表格儲存格中的內容。
詳情請參閱「插入、刪除及移動文字」。