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