- HTTP リクエスト
- パスパラメータ
- クエリ パラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- ThumbnailProperties
- MimeType
- ThumbnailSize
- 試してみる
プレゼンテーション内の指定されたページの最新バージョンのサムネイルを生成し、サムネイル画像の URL を返します。
このリクエストは、割り当て上、コストの高い読み取りリクエストとしてカウントされます。
HTTP リクエスト
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
presentationId |
取得するプレゼンテーションの ID。 |
pageObjectId |
サムネイルを取得するページのオブジェクト ID。 |
クエリ パラメータ
パラメータ | |
---|---|
thumbnailProperties |
サムネイルのプロパティ。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
ページのサムネイル。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "width": integer, "height": integer, "contentUrl": string } |
フィールド | |
---|---|
width |
サムネイル画像の正の幅(ピクセル単位)。 |
height |
サムネイル画像の高さ(ピクセル単位)。 |
contentUrl |
サムネイル画像のコンテンツ URL。 イメージの URL のデフォルトの存続期間は 30 分です。この URL には、リクエスト元のアカウントがタグ付けされます。この URL を知っているユーザーは誰でも、元のリクエスト元として効果的に画像にアクセスできます。プレゼンテーションの共有設定を変更すると、画像にアクセスできなくなる可能性があります。サムネイル画像の MIME タイプは |
承認スコープ
次の 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 |
サムネイル画像の MIME タイプ(省略可)。 MIME タイプを指定しない場合、MIME タイプはデフォルトで PNG になります。 |
thumbnailSize |
サムネイル画像のサイズ(省略可)。 サイズを指定しない場合、サーバーによって画像のデフォルト サイズが選択されます。 |
MimeType
サムネイル画像の MIME タイプ。
列挙型 | |
---|---|
PNG |
デフォルトの MIME タイプ。 |
ThumbnailSize
事前定義されたサムネイル画像のサイズ。
列挙型 | |
---|---|
THUMBNAIL_SIZE_UNSPECIFIED |
デフォルトのサムネイル画像サイズ。 サムネイル サイズが指定されていません。これは、将来変化する可能性のある方法でサーバーが画像のサイズを選択することを意味します。 |
LARGE |
サムネイル画像の幅: 1,600 ピクセル。 |
MEDIUM |
サムネイル画像の幅: 800 ピクセル。 |
SMALL |
サムネイル画像の幅: 200 ピクセル。 |