結構編輯規則和行為

本節說明使用 Google 文件 API 編輯文件時，您必須瞭解的行為和限制。

一般來說，您無法執行會導致文件內元素結構無效的編輯作業。請查看每個 documents.batchUpdate 要求方法，瞭解適用於這些要求的限制和規則。

以下各節將摘要說明這些方法的主要規則。

插入文字

  • 插入換行字元會在該索引處隱含建立 Paragraph。新段落的段落樣式會從目前插入索引的段落複製，包括清單和項目符號。
  • 文字必須插入現有 Paragraph 的界線內。舉例來說，文字無法插入表格的起始索引。文字必須插入前一段落。
  • 為避免在 Unicode 字素叢集內插入內容，API 可能會隱含調整位置。發生這種情況時，系統會將文字插入字素叢集後方。
  • 系統會自動決定插入文字的樣式，通常會保留鄰近文字的樣式。一般來說，插入文字的樣式會與插入索引前的文字相符。
  • 系統會從插入的文字中移除部分控制字元 (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 或 Equation 的開頭或結尾，但未刪除整個元素。

    • 刪除 Table、TableOfContents 或 SectionBreak 前的新行字元，但不要刪除元素。

    • 刪除表格中的個別列或儲存格。允許刪除表格儲存格中的內容。

  • 詳情請參閱「插入、刪除及移動文字」。