Method: documents.create

リクエストで指定されたタイトルを使用して、空白のドキュメントを作成します。リクエスト内の他のフィールド（提供されたコンテンツを含む）は無視されます。

作成されたドキュメントを返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

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

詳しくは、承認ガイドをご覧ください。