使用请求中提供的标题创建空白文档。请求中的其他字段(包括任何提供的内容)会被忽略。
返回创建的文档。
HTTP 请求
POST https://docs.googleapis.com/v1/documents
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
字段 | |
---|---|
document |
仅限输出。文档的 ID。 |
title |
文档的标题。 |
tabs[] |
文档中的标签页。 标签页可以包含子标签页,即嵌套在其他标签页中的标签页。子标签页由 |
revision |
仅限输出。文档的修订 ID。可在更新请求中使用,用于指定要将更新应用到文档的哪个修订版,以及如果文档在该修订版之后被修改,请求应如何处理。仅当用户拥有文档的编辑权限时才会填充。 修订版本 ID 不是顺序编号,而是一个不透明字符串。修订 ID 的格式可能会随时间而变化。返回的修订 ID 仅保证在返回后的 24 小时内有效,并且不能在用户之间共享。如果在两次调用之间修订 ID 保持不变,则表示文档未发生更改。反之,如果 ID 发生了更改(对于同一文档和用户),通常表示文档已更新。不过,ID 更改也可能是由内部因素(例如 ID 格式更改)导致的。 |
suggestions |
仅限输出。应用于文档的建议视图模式。 注意:修改文档时,必须基于包含 |
body |
仅限输出。文档的正文。 旧版字段:请改用 |
headers |
仅限输出。文档中的标题,按标题 ID 键控。 旧版字段:请改用 |
footers |
仅限输出。文档中的页脚,按页脚 ID 键控。 旧版字段:请改用 |
footnotes |
仅限输出。文档中的脚注,按脚注 ID 键值对排列。 旧版字段:请改用 |
document |
仅限输出。文档的样式。 旧版字段:请改用 |
suggested |
仅限输出。对文档样式的建议更改,按建议 ID 编入键值对。 旧版字段:请改用 |
named |
仅限输出。文档的命名样式。 旧版字段:请改用 |
suggested |
仅限输出。对文档命名样式的建议更改,按建议 ID 编入键值对。 旧版字段:请改用 |
lists |
仅限输出。文档中的列表,按列表 ID 键控。 旧版字段:请改用 |
named |
仅限输出。文档中的命名范围,按名称键值对排列。 旧版字段:请改用 |
inline |
仅限输出。文档中的内嵌对象,按对象 ID 键控。 旧版字段:请改用 |
positioned |
仅限输出。文档中已定位的对象,按对象 ID 键控。 旧版字段:请改用 |
响应正文
如果成功,响应正文将包含一个新创建的 Document
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
如需了解详情,请参阅授权指南。