在演示文稿中生成指定页面最新版本的缩略图,并返回一个指向缩略图的网址。
在配额方面,此请求计为高昂的读取请求。
HTTP 请求
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
presentationId |
要检索的演示文稿的 ID。 |
pageObjectId |
要检索其缩略图的页面的对象 ID。 |
查询参数
参数 | |
---|---|
thumbnailProperties |
缩略图属性。 |
请求正文
请求正文必须为空。
响应正文
网页的缩略图。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "width": integer, "height": integer, "contentUrl": string } |
字段 | |
---|---|
width |
缩略图的正宽度(以像素为单位)。 |
height |
缩略图的正高度(以像素为单位)。 |
contentUrl |
缩略图的内容网址。 指向图片的默认生命周期为 30 分钟。此网址已标记为请求者的帐号。拥有该网址的任何人都能以原始请求者的身份有效访问图片。如果演示文稿的共享设置发生变化,图片可能会丢失。缩略图的 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 |
缩略图的可选 MIME 类型。 如果您未指定 MIME 类型,则 MIME 类型默认为 PNG。 |
thumbnailSize |
可选缩略图大小。 如果您未指定大小,服务器会选择图片的默认大小。 |
MimeType
缩略图的 MIME 类型。
枚举 | |
---|---|
PNG |
默认的 MIME 类型。 |
缩略图尺寸
预定义的缩略图尺寸。
枚举 | |
---|---|
THUMBNAIL_SIZE_UNSPECIFIED |
默认的缩略图大小。 未指定的缩略图大小意味着服务器选择图片的大小时,将来可能会有所变化。 |
LARGE |
缩略图宽度为 1600 像素。 |
MEDIUM |
800 像素的缩略图宽度。 |
SMALL |
缩略图宽度为 200 像素。 |