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