Google Document API 總覽

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

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

  • 自動化程序
  • 大量建立文件
  • 設定文件格式
  • 產生應付憑據或合約
  • 擷取物件的特定屬性

以下列出 Docs API 中常用的術語：

Document ID

文件的專屬 ID。這是一個特殊字串，包含用來參照文件的英文字母、數字和部分特殊字元，可從文件的網址衍生而來。即使文件名稱有所變更，文件 ID 仍會保持不變。如要進一步瞭解如何查看 ID，請參閱「文件 ID」。

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

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

Google Workspace 文件

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

索引

內容主體中的大部分元素都具有 startIndex 和 endIndex 屬性。這些值會指出元素的開頭和結尾相對於其所屬 segment 開頭的偏移量。

內嵌圖片

在文件內文流程中顯示的圖片。這不是附件。

已命名範圍

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

Segment

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

建議

在不變更原始文字的情況下，對文件進行變更。建議內容若獲得擁有者核准，就會取代原始文字。

  • 如要瞭解如何使用 Google Workspace API 進行開發，包括處理驗證和授權，請參閱「在 Google Workspace 上開發」。

  • 如要瞭解文件的概念概略，請參閱「文件」。

  • 如要瞭解如何設定及執行 Docs API 應用程式，請試試 JavaScript 快速入門。