Method: documents.create

使用要求中提供的標題建立空白文件。系統會忽略要求中的其他欄位，包括提供的任何內容。

傳回建立的文件。

HTTP 要求

POST https://docs.googleapis.com/v1/documents

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "commentsViewMode": enum (CommentsViewMode),
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "suggestions": [
    {
      object (SuggestionThread)
    }
  ],
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
欄位
documentId

string

僅供輸出。文件的 ID。
title

string

文件的標題。
tabs[]

object (Tab)

文件中的分頁。

分頁可以包含子分頁，也就是巢狀分頁。子分頁會以 Tab.childTabs 欄位表示。
revisionId

string

僅供輸出。文件的修訂版本 ID。可用於更新要求，指定要將更新套用至哪個文件修訂版本，以及文件自該修訂版本編輯後，要求應如何運作。只有在使用者擁有文件的編輯權限時，才會填入這項資訊。

修訂版本 ID 不是序號，而是不透明的字串。修訂版本 ID 的格式可能會隨時間而有所異動。系統傳回的修訂版本 ID 僅保證在傳回後的 24 小時內有效，且無法在使用者之間共用。如果兩次呼叫之間的修訂版本 ID 沒有變更，表示文件未變更。相反地，如果 ID 變更 (針對相同文件和使用者)，通常表示文件已更新。不過，ID 變更也可能是因為內部因素，例如 ID 格式變更。
suggestionsViewMode

enum (SuggestionsViewMode)

僅供輸出。套用至文件的建議檢視模式。

注意：編輯文件時，變更內容必須以含有 SUGGESTIONS_INLINE 的文件為依據。
commentsViewMode

enum (CommentsViewMode)

僅供輸出。套用至文件的註解檢視模式。
comments[]

object (CommentThread)

僅供輸出。與文件相關的註解。只有在 commentsViewMode 參數設為需要留言時 (例如 COMMENTS_VIEW_MODE_INCLUDED)，才會填入這個值。
suggestions[]

object (SuggestionThread)

僅供輸出。與文件相關的建議。只有在 commentsViewMode 參數設為需要留言時 (例如 COMMENTS_VIEW_MODE_INCLUDED)，才會填入這個值。
body

object (Body)

僅供輸出。文件的主要內容。

舊版欄位：請改用 Document.tabs.documentTab.body，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
headers

map (key: string, value: object (Header))

僅供輸出。文件中的標題，以標題 ID 做為鍵。

舊版欄位：請改用 Document.tabs.documentTab.headers，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
footers

map (key: string, value: object (Footer))

僅供輸出。文件中的頁尾，以頁尾 ID 做為鍵。

舊版欄位：請改用 Document.tabs.documentTab.footers，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
footnotes

map (key: string, value: object (Footnote))

僅供輸出。文件中的註腳，以註腳 ID 為鍵。

舊版欄位：請改用 Document.tabs.documentTab.footnotes，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
documentStyle

object (DocumentStyle)

僅供輸出。文件的樣式。

舊版欄位：請改用 Document.tabs.documentTab.documentStyle，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
suggestedDocumentStyleChanges

map (key: string, value: object (SuggestedDocumentStyle))

僅供輸出。建議的文件樣式變更，以建議 ID 做為鍵。

舊版欄位：請改用 Document.tabs.documentTab.suggestedDocumentStyleChanges，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
namedStyles

object (NamedStyles)

僅供輸出。文件的具名樣式。

舊版欄位：請改用 Document.tabs.documentTab.namedStyles，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
suggestedNamedStylesChanges

map (key: string, value: object (SuggestedNamedStyles))

僅供輸出。建議對文件具名樣式進行的變更，以建議 ID 做為鍵。

舊版欄位：請改用 Document.tabs.documentTab.suggestedNamedStylesChanges，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
lists

map (key: string, value: object (List))

僅供輸出。文件中的清單，以清單 ID 做為鍵。

舊版欄位：請改用 Document.tabs.documentTab.lists，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
namedRanges

map (key: string, value: object (NamedRanges))

僅供輸出。文件中以名稱做為鍵的已命名範圍。

舊版欄位：請改用 Document.tabs.documentTab.namedRanges，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
inlineObjects

map (key: string, value: object (InlineObject))

僅供輸出。文件中的內嵌物件，以物件 ID 做為鍵。

舊版欄位：請改用 Document.tabs.documentTab.inlineObjects，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。
positionedObjects

map (key: string, value: object (PositionedObject))

僅供輸出。文件中已定位的物件，以物件 ID 做為鍵。

舊版欄位：請改用 Document.tabs.documentTab.positionedObjects，當 includeTabsContent 參數設為 true 時，這個欄位會顯示所有分頁的實際文件內容。如果為 false 或未設定，這個欄位會包含文件第一個分頁的相關資訊。

回應主體

如果成功，回應主體會包含新建立的 Document 執行個體。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

詳情請參閱授權指南。