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