使用请求中提供的标题创建空白演示文稿。如果提供了 presentationId
,则系统会将其用作新演示文稿的 ID。否则,系统会生成新的 ID。请求中的其他字段(包括任何提供的内容)会被忽略。返回创建的演示文稿。
HTTP 请求
POST https://slides.googleapis.com/v1/presentations
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
字段 | |
---|---|
presentationId |
演示文稿的 ID。 |
pageSize |
演示文稿中页面的大小。 |
slides[] |
演示文稿中的幻灯片。幻灯片会继承幻灯片布局的属性。 |
title |
演示文稿的标题。 |
masters[] |
演示文稿中的幻灯片母版。幻灯片母版包含一组布局的所有常见页面元素和常见属性。它们有以下三种用途:
|
layouts[] |
演示文稿中的布局。布局是一种模板,用于确定继承该布局的幻灯片中内容的排列方式和样式。 |
locale |
演示文稿的语言区域,以 IETF BCP 47 语言标记的形式。 |
revisionId |
仅限输出。演示文稿的修订 ID。可在更新请求中使用,用于断言自上次读取操作以来演示文稿修订版本未发生更改。仅当用户拥有演示文稿的编辑权限时才会填充。 修订版本 ID 不是顺序编号,而是一个模糊的字符串。修订 ID 的格式可能会随时间而变化,因此应以不透明的方式对待。返回的修订 ID 仅保证在返回后的 24 小时内有效,并且不能在用户之间共享。如果两次调用之间的修订 ID 保持不变,则表示演示文稿未发生变化。反之,如果 ID 发生变化(对于同一演示文稿和用户),通常表示演示文稿已更新。不过,ID 更改也可能是由内部因素(例如 ID 格式更改)导致的。 |
notesMaster |
演示文稿中的备注母版。它有以下三个用途:
记事主表为只读。 |
响应正文
如果成功,响应正文将包含一个新创建的 Presentation
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
如需了解详情,请参阅授权指南。