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