Google Document API 總覽

Google Docs API 可讓您在 Google 文件中建立及修改文件。

應用程式可以整合 Docs API，根據使用者和系統提供的資料建立精美的文件。Docs API 可讓您：

  • 自動化相關程序
  • 大量建立文件
  • 設定文件格式
  • 產生月結單或合約
  • 擷取物件的特定屬性

以下是 Docs API 中常用詞彙的清單：

文件 ID

文件的專屬 ID。這個特定字串包含字母、數字，以及參照文件且可從文件網址衍生的某些特殊字元。即使文件名稱變更，文件 ID 也會保持固定。如要進一步瞭解如何找出 ID，請參閱「文件 ID」。

https://docs.google.com/document/d/DOCUMENT_ID/edit
元素

文件的組成結構。文件的頂層元素包括 Body、DocumentStyle 和 List。

Google Workspace 文件

Google Workspace 應用程式 (例如 Google 文件) 建立的檔案。 Google 文件的 MIME 類型格式為 application/vnd.google-apps.document。如需 MIME 類型清單，請參閱「 Google Workspace 和 Google 雲端硬碟支援的 MIME 類型」。

索引

內容主體中的大部分元素都有 startIndex 和 endIndex 屬性。這些表示元素開始和結束的偏移量 (相對於元素所含片段的開頭)。

內嵌圖片

文件內文字流顯示的圖片。這並不是附件

已命名範圍

連續的文字範圍。NamedRange 是具有相同 namedRangeId 的一組範圍。已命名範圍可讓開發人員將文件的部分內容與任意使用者定義的標籤建立關聯，以便日後透過程式讀取或編輯內容。文件可以包含多個名稱相同的已命名範圍，但每個已命名範圍都有專屬 ID。

Segment

Body、Header、Footer 或 Footnote 包含結構或內容元素。區隔中元素的索引相對於區隔的開頭。

建議

對文件進行變更，但原始文字不變。如果擁有者核准您的建議，系統就會取代原始文字。