本節說明使用 Google Document 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
或SectionBreak
前方的換行字元,而沒有刪除元素。刪除資料表中的個別列或儲存格。刪除資料表儲存格中的內容。
詳情請參閱「插入、刪除及移動文字」。