本節將說明您在導入應用程式前必須瞭解的行為和限制 即可使用 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
而無需刪除元素刪除資料表中的個別資料列或儲存格。刪除內容 表格儲存格中可以使用
詳情請參閱插入、刪除及移動 文字。