本節說明使用 Google Docs API 編輯文件時,您必須瞭解的行為和限制。
一般來說,如果編輯作業會導致文件中的元素結構無效,您就無法執行編輯作業。請查看各個 documents.batchUpdate
要求方法,瞭解適用於這些要求的限制和規則。
以下各節將摘要說明這些方法的主要規則。
插入文字
- 如果插入換行字元,系統會以隱含方式建立
Paragraph
,並在該索引建立。系統會從目前插入索引的段落複製新段落的樣式,包括清單和項目符號。 - 文字必須插入現有
Paragraph
的邊界內。例如,系統無法將文字插入資料表的起始索引。上述文字必須插入在前面的段落中。 - API 可能會間接調整位置,防止在 Unicode 圖表叢集內插入。發生這種情況時,文字會緊接在 Grapheme 叢集之後。
- 系統會自動決定插入文字的文字樣式,一般會保留鄰近文字的樣式。一般而言,插入文字的文字樣式會立即與插入索引之前的文字相符。
- 系統會將部分控製字元 (
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
前的換行字元,而不刪除元素。刪除資料表中的個別資料列或儲存格。允許刪除表格儲存格中的內容。
詳情請參閱「插入、刪除及移動文字」。