使用请求中指定的标题创建空白文档。请求中的其他字段(包括任何提供的内容)会被忽略。
返回创建的文档。
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
如需了解详情,请参阅授权指南。