Google Document API 總覽

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

應用程式可以整合文件 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 類型」。

Index

內容主體中的大多數元素都具有 startIndex 和 endIndex 屬性。這些值表示元素開始和結束的偏移量，計算基準是封閉 segment 的開頭。

內嵌圖片

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

已命名範圍

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

區隔

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

建議

你可以在不變更原始文字的情況下，在文件中提出修訂建議。建議內容若獲得擁有者核准，就會取代原始文字。