REST Resource: presentations.pages

资源：页面

演示文稿中的页面。

JSON 表示法 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
字段
objectId

string

此页面的对象 ID。Page 和 PageElement 使用的对象 ID 共用相同的命名空间。
pageType

enum (PageType)

网页的类型。
pageElements[]

object (PageElement)

在页面上呈现的页面元素。
revisionId

string

仅限输出。演示文稿的修订 ID。可在更新请求中使用，用于断言自上次读取操作以来演示文稿修订版本未发生更改。仅当用户拥有演示文稿的编辑权限时才会填充。

修订版本 ID 不是顺序编号，而是一个不透明字符串。修订 ID 的格式可能会随时间而变化。返回的修订 ID 仅保证在返回后的 24 小时内有效，并且不能在用户之间共享。如果两次调用之间的修订 ID 保持不变，则表示演示文稿未发生变化。反之，如果 ID 发生变化（对于同一演示文稿和用户），通常表示演示文稿已更新。不过，ID 更改也可能是由内部因素（例如 ID 格式更改）导致的。
pageProperties

object (PageProperties)

网页的属性。
联合字段 properties。特定于每种页面类型的属性。主视频不需要任何其他属性。properties 只能是下列其中一项：
slideProperties

object (SlideProperties)

滑动特定属性。仅在 pageType 为 SLIDE 时设置。
layoutProperties

object (LayoutProperties)

布局专用属性。仅当 pageType 为 LAYOUT 时设置。
notesProperties

object (NotesProperties)

注明特定媒体资源。仅当 pageType 为 NOTES 时才设置。
masterProperties

object (MasterProperties)

掌握特定媒体资源。仅当 pageType 为 MASTER 时设置。

PageType

页面的类型。

枚举
SLIDE 幻灯片页面。
MASTER 母版幻灯片页面。
LAYOUT 布局页面。
NOTES 记事页面。
NOTES_MASTER 记事母版页。

PageElement

在网页上呈现的视觉元素。

JSON 表示法 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
字段
objectId

string

此页面元素的对象 ID。google.apps.slides.v1.Page 和 google.apps.slides.v1.PageElement 使用的对象 ID 共用相同的命名空间。
size

object (Size)

页面元素的大小。
transform

object (AffineTransform)

页面元素的转换。

网页元素的外观取决于其绝对转换。如需计算绝对转换，请预先将网页元素的转换与其所有父级组的转换串联起来。如果网页元素不在组中，则其绝对转换与此字段中的值相同。

新创建的 Group 的初始转换始终是身份转换。
title

string

网页元素的标题。与说明搭配使用，以显示替代文本。

Group 元素不支持此字段。
description

string

页面元素的说明。与标题组合使用，以显示替代文本。

Group 元素不支持此字段。
联合字段 element_kind。此 PageElement 所代表的元素类型。每条消息都包含特定于该类型页面元素的所有属性。element_kind 只能是下列其中一项：
elementGroup

object (Group)

一组联接为单个单元的页面元素。
shape

object (Shape)

一般形状。
image

object (Image)

图片页面元素。
video

object (Video)

视频页面元素。
line

object (Line)

线条页面元素。
table

object (Table)

表格页面元素。
wordArt

object (WordArt)

艺术字页面元素。
sheetsChart

object (SheetsChart)

从 Google 表格中嵌入的关联图表。未关联的图表显示为图片。
speakerSpotlight

object (SpeakerSpotlight)

演讲者聚焦。

群组

一种 PageElement 类型，表示 PageElement 的联接集合。

JSON 表示法 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
字段
children[]

object (PageElement)

组中的元素集合。组的大小不得低于 2。

WordArt

表示文字艺术的 PageElement 类型。

JSON 表示法 
{
  "renderedText": string
}
字段
renderedText

string

以文字艺术形式呈现的文本。

SpeakerSpotlight

表示演讲者特写的 PageElement 类型。

JSON 表示法 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
字段
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

演讲者特写的属性。

SpeakerSpotlightProperties

SpeakerSpotlight 的属性。

JSON 表示法 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
字段
outline

object (Outline)

演讲者聚焦的轮廓。如果未设置，则没有轮廓。
shadow

object (Shadow)

演讲者聚焦的阴影。如果未设置，则没有阴影。

SlideProperties

仅与页面类型为 SLIDE 的页面相关的 Page 属性。

JSON 表示法 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
字段
layoutObjectId

string

此幻灯片所依据的布局的对象 ID。此属性为只读属性。
masterObjectId

string

此幻灯片所依据的母版的对象 ID。此属性为只读属性。
notesPage

object (Page)

此幻灯片关联的记事页。它用于定义在打印或导出包含演讲者备注的幻灯片时备注页的视觉外观。记事页会继承 notes master 的属性。备注页上类型为 BODY 的占位符形状包含此幻灯片的演讲者备注。此形状的 ID 由 speakerNotesObjectId 字段标识。备注页是只读的，但演讲者备注形状的文本内容和样式除外。此属性为只读属性。
isSkipped

boolean

幻灯片在演示模式下是否会被跳过。默认值为 false。

LayoutProperties

Page 的属性仅与 pageType 为 LAYOUT 的网页相关。

JSON 表示法 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
字段
masterObjectId

string

此布局所依据的父级对象的 ID。
name

string

布局的名称。
displayName

string

布局的直观易懂的名称。

NotesProperties

仅与页面类型为 NOTES 的网页相关的 Page 属性。

JSON 表示法 
{
  "speakerNotesObjectId": string
}
字段
speakerNotesObjectId

string

此记事页上包含相应幻灯片讲者备注的形状的对象 ID。实际形状可能并不总是出现在记事页面上。使用此对象 ID 插入文本时，系统会自动创建形状。在这种情况下，实际形状可能具有不同的对象 ID。presentations.get 或 pages.get 操作始终会返回最新的对象 ID。

MasterProperties

仅与页面类型为 MASTER 的网页相关的 Page 属性。

JSON 表示法 
{
  "displayName": string
}
字段
displayName

string

主副本的直观易懂的名称。

PageProperties

Page 的属性。

该网页将继承父级网页的属性。层次结构是在 SlideProperties 或 LayoutProperties 中定义的，具体取决于网页类型。

JSON 表示法 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
字段
pageBackgroundFill

object (PageBackgroundFill)

网页的背景填充。如果未设置，则背景填充会从父页面（如果存在）继承。如果页面没有父级，则背景填充会默认采用 Google 幻灯片编辑器中的相应填充。
colorScheme

object (ColorScheme)

页面的配色方案。如果未设置，则配色方案会从父页面继承。如果页面没有父级，配色方案将使用默认的 Google 幻灯片配色方案，与 Google 幻灯片编辑器中的默认配色方案一致。

只有前 12 个 ThemeColorType 的具体颜色是可修改的。此外，只能更新 Master 页面上的配色方案。如需更新此字段，必须提供一个配色方案，其中包含将前 12 个 ThemeColorType 映射到其具体颜色的映射。系统会忽略其余 ThemeColorType 的颜色。

PageBackgroundFill

页面背景填充。

JSON 表示法 
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
字段
propertyState

enum (PropertyState)

背景填充属性状态。

更新网页上的填充内容将会隐式将此字段更新为 RENDERED，除非在同一请求中指定了其他值。如需在页面上不显示填充内容，请将此字段设置为 NOT_RENDERED。在这种情况下，系统会忽略在同一请求中设置的任何其他填充字段。
联合字段 kind。背景填充类型。kind 只能是下列其中一项：
solidFill

object (SolidFill)

填充纯色。
stretchedPictureFill

object (StretchedPictureFill)

拉伸的图片填充。

StretchedPictureFill

拉伸的图片填充。网页或网页元素完全填充了指定的图片。图片会被拉伸以适应其容器。

JSON 表示法 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
字段
contentUrl

string

读取 contentUrl：

指向图片的网址，默认有效期为 30 分钟。此网址会带有请求者的账号标记。知道该网址的任何人都可以以原始要求方身份访问照片。如果演示文稿的共享设置发生变化，您可能无法再访问该图片。

写入 contentUrl：

系统会在插入时提取一次图片，并存储一个副本以便在演示文稿中显示。图片大小不得超过 50MB，不得超过 2500 万像素，且必须为 PNG、JPEG 或 GIF 格式。

提供的网址长度不得超过 2 KB。
size

object (Size)

图片填充的原始尺寸。此字段为只读字段。

ColorScheme

页面的预定义颜色调色板。

JSON 表示法 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
字段
colors[]

object (ThemeColorPair)

ThemeColorType 和相应的具体颜色对。

ThemeColorPair

将主题颜色类型映射到其代表的具体颜色的对。

JSON 表示法 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
字段
type

enum (ThemeColorType)

主题颜色的类型。
color

object (RgbColor)

与上述主题颜色类型对应的具体颜色。

方法

get

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

getThumbnail

 生成演示文稿中指定页面最新版本的缩略图，并返回缩略图图片的网址。