フィードバックを送信
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
) ,
"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
詳細については、承認ガイド をご覧ください。
フィードバックを送信
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-07-30 UTC。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"必要な情報がない"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"複雑すぎる / 手順が多すぎる"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"最新ではない"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻訳に関する問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"サンプル / コードに問題がある"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"その他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"わかりやすい"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"問題の解決に役立った"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"その他"
}]
ご意見をお聞かせください
{"lastModified": "\u6700\u7d42\u66f4\u65b0\u65e5 2024-07-30 UTC\u3002"}
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2024-07-30 UTC。"]]