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 像素。