Method: presentations.pages.getThumbnail
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک تصویر کوچک از آخرین نسخه از صفحه مشخص شده در ارائه ایجاد می کند و یک URL را به تصویر کوچک برمی گرداند.
این درخواست به عنوان یک درخواست خواندن گران قیمت برای اهداف سهمیه به حساب می آید.
درخواست HTTP
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
presentationId | string شناسه ارائه برای بازیابی. |
pageObjectId | string شناسه شی صفحه که تصویر کوچک آن باید بازیابی شود. |
پارامترهای پرس و جو
| پارامترها |
|---|
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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
ویژگی های بند انگشتی
کنترل ایجاد تصویر کوچک صفحه را فراهم می کند.
| فیلدها |
|---|
mimeType | enum ( MimeType ) نوع میم اختیاری تصویر بند انگشتی. اگر نوع mime را مشخص نکنید، نوع mime پیش‌فرض PNG است. |
thumbnailSize | enum ( ThumbnailSize ) اندازه تصویر کوچک اختیاری. اگر اندازه را مشخص نکنید، سرور اندازه پیش فرض تصویر را انتخاب می کند. |
MimeType
نوع میم تصویر بند انگشتی.
| Enums |
|---|
PNG | نوع مایم پیش فرض |
اندازه بند انگشتی
اندازه های تصویر کوچک از پیش تعریف شده.
| Enums |
|---|
THUMBNAIL_SIZE_UNSPECIFIED | اندازه تصویر کوچک پیش فرض. اندازه تصویر کوچک نامشخص نشان می دهد که سرور اندازه تصویر را به گونه ای انتخاب می کند که ممکن است در آینده متفاوت باشد. |
LARGE | عرض تصویر کوچک 1600 پیکسل. |
MEDIUM | عرض تصویر کوچک 800 پیکسل. |
SMALL | عرض تصویر کوچک 200 پیکسل. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-03-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-03-25 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
