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 タイプを指定しない場合、デフォルトで PNG が使用されます。

thumbnailSize

enum (ThumbnailSize)

サムネイル画像のサイズ(省略可)。

サイズを指定しないと、サーバーは画像のデフォルト サイズを選択します。

MIME タイプ

サムネイル画像の MIME タイプ。

列挙型
PNG デフォルトの MIME タイプ。

サムネイルのサイズ

定義済みのサムネイル画像サイズ。

列挙型
THUMBNAIL_SIZE_UNSPECIFIED

デフォルトのサムネイル画像サイズ。

指定されていないサムネイル サイズは、今後使用される可能性のある方法で、サーバーが画像のサイズを選択することを意味します。

LARGE サムネイル画像の幅: 1,600 ピクセル。
MEDIUM サムネイル画像の幅は 800 ピクセルです。
SMALL サムネイル画像の幅は 200 ピクセルです。