REST Resource: presentations

资源:演示文稿

Google 幻灯片演示文稿。

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)

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

方法

batchUpdate

对演示文稿应用一项或多项更新。

create

使用请求中给定的标题创建空白演示文稿。

get

获取指定演示文稿的最新版本。