Method: presentations.pages.getThumbnail

プレゼンテーション内の指定したページの最新バージョンのサムネイルを生成して、サムネイル画像の URL を返します。

このリクエストは、割り当ての計算上、高負荷の読み取りリクエストとしてカウントされます。

HTTP リクエスト

GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
presentationId

string

取得するプレゼンテーションの ID。
pageObjectId

string

サムネイルを取得するページのオブジェクト ID。

クエリ パラメータ

パラメータ
thumbnailProperties

object (ThumbnailProperties)

サムネイルのプロパティ。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

ページのサムネイル。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
フィールド
width

integer

サムネイル画像の幅（ピクセル単位）。正の値にする必要があります。
height

integer

サムネイル画像の高さ（ピクセル単位）。正の値にする必要があります。
contentUrl

string

サムネイル画像のコンテンツ URL。

画像の URL のデフォルトの有効期間は 30 分です。この URL には、リクエスト元のアカウントのタグが付けられます。URL を知っているユーザーは誰でも、元のリクエスト元として画像にアクセスできます。プレゼンテーションの共有設定が変更されると、画像にアクセスできなくなる可能性があります。サムネイル画像の 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 サムネイル画像の幅は 1,600 ピクセルです。
MEDIUM サムネイル画像の幅は 800 ピクセルです。
SMALL サムネイル画像の幅は 200 ピクセルです。