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