使用请求中指定的标题创建空白文档。请求中的其他字段(包括提供的任何内容)都会被忽略。
返回创建的文档。
HTTP 请求
POST https://docs.googleapis.com/v1/documents
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
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
有关详情,请参阅授权指南。