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 類型，系統會預設為 PNG。
thumbnailSize

enum (ThumbnailSize)

選用的縮圖圖片大小。

如果未指定大小，伺服器會選擇圖片的預設大小。

MimeType

縮圖圖片的 MIME 類型。

列舉
PNG 預設 MIME 類型。

ThumbnailSize

預先定義的縮圖大小。

列舉
THUMBNAIL_SIZE_UNSPECIFIED

預設縮圖圖片大小。

未指定縮圖大小，表示伺服器選擇圖片大小的方式日後可能會有所不同。
LARGE 縮圖圖片寬度為 1600 像素。
MEDIUM 縮圖圖片的寬度為 800 像素。
SMALL 縮圖圖片的寬度為 200 像素。