生成演示文稿中指定页面最新版本的缩略图,并返回指向缩略图的网址。
在进行配额计算时,系统会将此请求视为成本高昂的读取请求。
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
有关详情,请参阅授权指南。
ThumbnailProperties
用于控制页面缩略图创建。
JSON 表示法 |
---|
{ "mimeType": enum ( |
字段 | |
---|---|
mimeType |
缩略图的可选 MIME 类型。 如果您未指定 MIME 类型,则 MIME 类型默认为 PNG。 |
thumbnailSize |
缩略图图片大小(可选)。 如果您未指定图片大小,服务器会选择图片的默认大小。 |
MimeType
缩略图的 MIME 类型。
枚举 | |
---|---|
PNG |
默认 MIME 类型。 |
ThumbnailSize
预定义的缩略图图片大小。
枚举 | |
---|---|
THUMBNAIL_SIZE_UNSPECIFIED |
默认的缩略图图片大小。 未指定缩略图大小意味着服务器以将来可能发生变化的方式选择图片大小。 |
LARGE |
缩略图宽度为 1600 像素。 |
MEDIUM |
缩略图宽度为 800 像素。 |
SMALL |
缩略图宽度为 200 像素。 |