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 中指定的 MIME 类型相同。

授权范围

需要以下 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

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

缩略图属性

控制网页缩略图的创建。

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

enum (MimeType)

缩略图的可选 MIME 类型。

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

thumbnailSize

enum (ThumbnailSize)

可选缩略图大小。

如果您未指定大小,服务器会选择图片的默认大小。

MimeType

缩略图的 MIME 类型。

枚举
PNG 默认的 MIME 类型。

缩略图尺寸

预定义的缩略图尺寸。

枚举
THUMBNAIL_SIZE_UNSPECIFIED

默认的缩略图大小。

未指定的缩略图大小意味着服务器选择图片的大小时,将来可能会有所变化。

LARGE 缩略图宽度为 1600 像素。
MEDIUM 800 像素的缩略图宽度。
SMALL 缩略图宽度为 200 像素。