Method: presentations.pages.getThumbnail

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

在计算配额时，此请求会计为耗时读取请求。

HTTP 请求

GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail

网址采用 gRPC 转码语法。

路径参数

参数
presentationId

string

要检索的演示文稿的 ID。
pageObjectId

string

要检索缩略图的页面的对象 ID。

查询参数

参数
thumbnailProperties

object (ThumbnailProperties)

缩略图属性。

请求正文

请求正文必须为空。

响应正文

页面的缩略图。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
字段
width

integer

缩略图的宽度（以像素为单位，正值）。
height

integer

缩略图的高度（以像素为单位，正值）。
contentUrl

string

缩略图图片的内容网址。

图片的网址默认有效期为 30 分钟。此网址会带有请求者的账号标记。拥有该网址的任何人都可以以原始请求者的身份有效访问图片。如果演示文稿的共享设置发生变化，您可能会失去对图片的访问权限。缩略图图片的 MIME 类型与 GetPageThumbnailRequest 中指定的类型相同。

授权范围

需要以下 OAuth 范围之一：

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

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

ThumbnailProperties

提供对网页缩略图创建的控制。

JSON 表示法 
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
字段
mimeType

enum (MimeType)

缩略图的 MIME 类型（可选）。

如果您未指定 MIME 类型，则 MIME 类型默认为 PNG。
thumbnailSize

enum (ThumbnailSize)

可选的缩略图图片尺寸。

如果您未指定尺寸，服务器会选择图片的默认尺寸。

MimeType

缩略图的 MIME 类型。

枚举
PNG 默认的 MIME 类型。

ThumbnailSize

预定义的缩略图图片大小。

枚举
THUMBNAIL_SIZE_UNSPECIFIED

默认的缩略图大小。

未指定缩略图大小意味着服务器选择图片大小的方式未来可能会有所不同。
LARGE 缩略图的宽度为 1600 像素。
MEDIUM 缩略图宽度为 800 像素。
SMALL 缩略图的宽度为 200 像素。