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 ピクセル。