結構編輯規則和行為

本節將說明您在導入應用程式前必須瞭解的行為和限制 即可使用 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 的邊界內。適用對象 例如,無法將文字插入表格的起始索引。
  • 無法在註腳或方程式中插入圖片。
  • 詳情請參閱「插入內嵌圖片」。

設定文字格式

  • 將段落層級的格式設定套用至範圍時, 只套用至部分或完全重疊的段落 範圍。
  • 範圍可能會延伸,以納入相鄰的換行符號。
  • 如果這個範圍完整包含某個清單內的段落,該段落的 項目符號也會更新為相符的文字樣式。
  • 詳情請參閱「設定文字格式」。

建立段落項目符號

  • 為與特定範圍重疊的所有段落建立項目符號。
  • 每個段落的巢狀結構層級取決於 。
  • 建立項目符號時,系統會移除開頭的分頁,這些設定可能會改變 文字的各部分索引。
  • 如上隨後加入符合清單的項目符號 即可將這個段落加入清單。
  • 詳情請參閱使用清單

刪除文字

  • 如果刪除超過段落邊界的文字,系統可能會變更 文字段落樣式、清單、定位物件和書籤 段落會合併。

  • 我們不允許刪除會造成無效的文件結構。只有部分通知 無效刪除要求的示例包括:

    • 刪除代理值組的一個代碼單位。

    • 刪除 BodyHeaderFooterFootnote, TableCell,或 TableOfContents

    • 刪除開頭或結尾 TableTableOfContents,或 Equation,不使用 因此會刪除整個元素

    • 刪除 TableTableOfContentsSectionBreak敬上 而無需刪除元素

    • 刪除資料表中的個別資料列或儲存格。刪除內容 表格儲存格中可以使用

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