Method: presentations.pages.getThumbnail
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Membuat thumbnail versi terbaru halaman yang ditentukan dalam presentasi dan menampilkan URL ke gambar thumbnail.
Permintaan ini dihitung sebagai permintaan baca yang mahal untuk tujuan kuota.
Permintaan HTTP
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
presentationId |
string
ID presentasi yang akan diambil.
|
pageObjectId |
string
ID objek halaman yang thumbnail-nya akan diambil.
|
Parameter kueri
| Parameter |
thumbnailProperties |
object (ThumbnailProperties)
Properti thumbnail.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Thumbnail halaman.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"width": integer,
"height": integer,
"contentUrl": string
} |
| Kolom |
width |
integer
Lebar positif dalam piksel dari gambar thumbnail.
|
height |
integer
Tinggi positif dalam piksel dari gambar thumbnail.
|
contentUrl |
string
URL konten gambar thumbnail. URL ke gambar memiliki masa berlaku default 30 menit. URL ini diberi tag dengan akun pemohon. Siapa pun yang memiliki URL tersebut dapat mengakses gambar secara efektif sebagai pemohon asli. Akses ke gambar dapat hilang jika setelan berbagi presentasi berubah. Jenis mime gambar thumbnail sama dengan yang ditentukan dalam GetPageThumbnailRequest.
|
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/presentationshttps://www.googleapis.com/auth/presentations.readonly
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.
ThumbnailProperties
Memberikan kontrol atas pembuatan thumbnail halaman.
| Kolom |
mimeType |
enum (MimeType)
Jenis mime opsional dari gambar thumbnail. Jika Anda tidak menentukan jenis mime, jenis mime akan ditetapkan secara default ke PNG.
|
thumbnailSize |
enum (ThumbnailSize)
Ukuran gambar thumbnail opsional. Jika Anda tidak menentukan ukuran, server akan memilih ukuran default gambar.
|
Jenis Mime
Jenis MIME gambar thumbnail.
| Enum |
PNG |
Jenis mime default. |
ThumbnailSize
Ukuran gambar thumbnail yang telah ditetapkan.
| Enum |
THUMBNAIL_SIZE_UNSPECIFIED |
Ukuran gambar thumbnail default. Ukuran thumbnail yang tidak ditentukan menyiratkan bahwa server memilih ukuran gambar dengan cara yang mungkin bervariasi pada masa mendatang. |
LARGE |
Lebar gambar thumbnail 1.600 piksel. |
MEDIUM |
Lebar gambar thumbnail 800 piksel. |
SMALL |
Lebar gambar thumbnail 200 piksel. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-03-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-03-25 UTC."],[],[],null,["# Method: presentations.pages.getThumbnail\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Thumbnail.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ThumbnailProperties](#ThumbnailProperties)\n - [JSON representation](#ThumbnailProperties.SCHEMA_REPRESENTATION)\n- [MimeType](#MimeType)\n- [ThumbnailSize](#ThumbnailSize)\n- [Try it!](#try-it)\n\nGenerates a thumbnail of the latest version of the specified page in the presentation and returns a URL to the thumbnail image.\n\nThis request counts as an [expensive read request](https://developers.google.com/workspace/slides/limits) for quota purposes.\n\n### HTTP request\n\n`GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------|-----------------------------------------------------------------|\n| `presentationId` | `string` The ID of the presentation to retrieve. |\n| `pageObjectId` | `string` The object ID of the page whose thumbnail to retrieve. |\n\n### Query parameters\n\n| Parameters ||\n|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `thumbnailProperties` | `object (`[ThumbnailProperties](/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#ThumbnailProperties)`)` The thumbnail properties. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe thumbnail of a page.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------|\n| ``` { \"width\": integer, \"height\": integer, \"contentUrl\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `width` | `integer` The positive width in pixels of the thumbnail image. |\n| `height` | `integer` The positive height in pixels of the thumbnail image. |\n| `contentUrl` | `string` The content URL of the thumbnail image. The URL to the image has a default lifetime of 30 minutes. This URL is tagged with the account of the requester. Anyone with the URL effectively accesses the image as the original requester. Access to the image may be lost if the presentation's sharing settings change. The mime type of the thumbnail image is the same as specified in the `GetPageThumbnailRequest`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `https://www.googleapis.com/auth/drive.file`\n- `https://www.googleapis.com/auth/drive.readonly`\n- `https://www.googleapis.com/auth/presentations`\n- `https://www.googleapis.com/auth/presentations.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nThumbnailProperties\n-------------------\n\nProvides control over page thumbnail creation.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"mimeType\": enum (/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#MimeType), \"thumbnailSize\": enum (/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#ThumbnailSize) } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `mimeType` | `enum (`[MimeType](/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#MimeType)`)` The optional mime type of the thumbnail image. If you don't specify the mime type, the mime type defaults to PNG. |\n| `thumbnailSize` | `enum (`[ThumbnailSize](/workspace/slides/api/reference/rest/v1/presentations.pages/getThumbnail#ThumbnailSize)`)` The optional thumbnail image size. If you don't specify the size, the server chooses a default size of the image. |\n\nMimeType\n--------\n\nThe mime type of the thumbnail image.\n\n| Enums ||\n|-------|------------------------|\n| `PNG` | The default mime type. |\n\nThumbnailSize\n-------------\n\nThe predefined thumbnail image sizes.\n\n| Enums ||\n|------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `THUMBNAIL_SIZE_UNSPECIFIED` | The default thumbnail image size. The unspecified thumbnail size implies that the server chooses the size of the image in a way that might vary in the future. |\n| `LARGE` | The thumbnail image width of 1600px. |\n| `MEDIUM` | The thumbnail image width of 800px. |\n| `SMALL` | The thumbnail image width of 200px. |"]]
