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