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),
  "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 的文件，進行變更。
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

詳情請參閱授權指南。