Method: presentations.pages.getThumbnail
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает миниатюру последней версии указанной страницы в презентации и возвращает URL-адрес миниатюры изображения.
Этот запрос считается дорогостоящим запросом на чтение для целей квоты.
HTTP-запрос
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
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, по умолчанию будет использоваться тип mime PNG. |
thumbnailSize | enum ( ThumbnailSize ) Необязательный размер миниатюры изображения. Если вы не укажете размер, сервер выберет размер изображения по умолчанию. |
Миметип
MIME-тип миниатюры изображения.
Перечисления |
---|
PNG | Тип MIME по умолчанию. |
Размер миниатюры
Предопределенные размеры миниатюр изображений.
Перечисления |
---|
THUMBNAIL_SIZE_UNSPECIFIED | Размер миниатюры изображения по умолчанию. Неуказанный размер миниатюры означает, что сервер выбирает размер изображения таким образом, который может измениться в будущем. |
LARGE | Ширина миниатюры изображения 1600 пикселей. |
MEDIUM | Ширина миниатюры изображения 800 пикселей. |
SMALL | Ширина миниатюры изображения 200 пикселей. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-03-25 UTC.
[null,null,["Последнее обновление: 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. |"]]