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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
字段
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 上。

备注母版是只读的。
comments[]

object (CommentThread)

仅限输出。与演示文稿关联的评论会话。
commentsViewMode

enum (CommentsViewMode)

仅限输出。应用于演示文稿的评论视图模式。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

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

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