Method: presentations.create

使用请求中提供的标题创建空白演示文稿。如果提供了 presentationId,系统会将其用作新演示文稿的 ID。否则,将生成一个新 ID。请求中的其他字段(包括所提供的内容)都会被忽略。返回已创建的演示文稿。

HTTP 请求

POST https://slides.googleapis.com/v1/presentations

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
字段
presentationId

string

演示文稿的 ID。

pageSize

object (Size)

演示文稿中的页面大小。

slides[]

object (Page)

演示文稿中的幻灯片。幻灯片会继承幻灯片布局中的属性。

title

string

演示文稿的标题。

masters[]

object (Page)

幻灯片母版位于演示文稿中。幻灯片母版包含一组布局的所有常见页面元素和通用属性。它们有三个用途:

  • 母版上的占位符形状包含使用该母版的网页上的所有占位符形状的默认文本样式和形状属性。
  • 主页面属性定义其布局继承的常见页面属性。
  • 无论采用何种布局,母版幻灯片上的任何其他形状都会显示在使用母版的所有幻灯片上。
layouts[]

object (Page)

演示文稿中的布局。布局是一种模板,用于确定内容在继承自该布局的幻灯片上的排列方式和样式。

locale

string

演示文稿的语言区域,采用 IETF BCP 47 语言标记。

revisionId

string

仅供输出。演示文稿的修订版本 ID。可用于更新请求中以声明自上次读取操作以来未更改呈现修订版本。仅当用户拥有演示文稿的编辑权限时填充。

修订版本 ID 不是序列号,而是模糊字符串。修订版本 ID 的格式可能会随时间而改变,因此应视为不透明。返回的修订版本 ID 仅在其返回后的 24 小时内有效,不能在用户之间共享。如果不同调用之间的修订版本 ID 保持不变,则表示演示文稿并未更改。相反,更改后的 ID(适用于同一演示文稿和用户)通常意味着该演示文稿已更新。但是,ID 也可能是由于内部因素(例如 ID 格式更改)而产生的。

notesMaster

object (Page)

演示文稿中的备注均为母版。它有三个用途:

  • 备注母版上的占位符形状包含 notes pages 中所有占位符形状的默认文本样式和形状属性。具体而言,SLIDE_IMAGE 占位符形状包含幻灯片缩略图,BODY 占位符形状包含演讲者备注。
  • 备注主页面属性定义了所有 notes pages 继承的通用页面属性。
  • 备注母版上的任何其他形状都会显示在所有 notes pages 上。

备注母版为只读版本。

响应正文

如果成功,响应正文将包含一个新创建的 Presentation 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

如需了解详情,请参阅授权指南