リクエストで指定されたタイトルを使用して空白のドキュメントを作成します。リクエスト内の他のフィールド(指定されたコンテンツを含む)は無視されます。
作成されたドキュメントを返します。
HTTP リクエスト
POST https://docs.googleapis.com/v1/documents
この URL は gRPC Transcoding 構文を使用します。
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
フィールド | |
---|---|
documentId |
出力専用。ドキュメントの ID。 |
title |
ドキュメントのタイトル。 |
tabs[] |
ドキュメントの一部であるタブ。 タブには子タブ(別のタブ内にネストされたタブ)を含めることができます。子タブは |
revisionId |
出力専用。ドキュメントのリビジョン ID。更新リクエストで使用して、更新を適用するドキュメントのどのリビジョンと、そのリビジョン以降にドキュメントが編集された場合のリクエストの動作を指定できます。ユーザーがドキュメントの編集権限を持っている場合にのみ入力されます。 リビジョン ID は連番ではなく、不透明な文字列です。リビジョン ID の形式は、今後変更される可能性があります。返されたリビジョン ID の有効期間は 24 時間のみ保証され、ユーザー間で共有することはできません。呼び出し間でリビジョン ID が変更されていない場合、ドキュメントは変更されていません。逆に、ID が変更された場合(同じドキュメントとユーザーの場合)は、通常、ドキュメントが更新されたことを意味します。ただし、ID の形式の変更などの内部要因が原因で ID が変更される場合もあります。 |
suggestionsViewMode |
出力専用。ドキュメントに適用されている候補ビューモード。 注: ドキュメントを編集する場合、変更は |
body |
出力専用。ドキュメントの本文。 従来フィールド: 代わりに |
headers |
出力専用。ヘッダー ID をキーとするドキュメント内のヘッダー。 従来フィールド: 代わりに |
footers |
出力専用。ドキュメント内のフッター(フッター ID でキー設定)。 以前のフィールド: 代わりに |
footnotes |
出力専用。ドキュメント内の脚注(脚注 ID でキーが設定されています)。 以前のフィールド: 代わりに |
documentStyle |
出力専用。ドキュメントのスタイル。 従来フィールド: 代わりに |
suggestedDocumentStyleChanges |
出力専用。候補 ID をキーとする、ドキュメントのスタイルに対する変更の提案。 従来フィールド: 代わりに |
namedStyles |
出力専用。ドキュメントの名前付きスタイル。 以前のフィールド: 代わりに |
suggestedNamedStylesChanges |
出力専用。ドキュメントの名前付きスタイルに対する提案。候補 ID をキーに指定します。 以前のフィールド: 代わりに |
lists |
出力専用。ドキュメント内のリスト(リスト ID がキー)。 以前のフィールド: 代わりに |
namedRanges |
出力専用。名前をキーとして持つ、ドキュメント内の名前付き範囲。 従来フィールド: 代わりに |
inlineObjects |
出力専用。オブジェクト ID をキーとするドキュメント内のインライン オブジェクト。 従来フィールド: 代わりに |
positionedObjects |
出力専用。ドキュメント内の配置済みオブジェクト(オブジェクト ID をキーとする)。 従来フィールド: 代わりに |
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Document
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
詳細については、承認ガイドをご覧ください。