Method: presentations.pages.getThumbnail
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Gera uma miniatura da versão mais recente da página especificada na apresentação e retorna um URL para a imagem da miniatura.
Essa solicitação é considerada uma solicitação de leitura cara para fins de cota.
Solicitação HTTP
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
presentationId |
string
O ID da apresentação a ser recuperada.
|
pageObjectId |
string
O ID do objeto da página de miniatura a ser recuperada.
|
Parâmetros de consulta
| Parâmetros |
thumbnailProperties |
object (ThumbnailProperties)
As propriedades da miniatura.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
A miniatura de uma página.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
| Representação JSON |
{
"width": integer,
"height": integer,
"contentUrl": string
} |
| Campos |
width |
integer
A largura positiva em pixels da imagem da miniatura.
|
height |
integer
A altura positiva em pixels da miniatura.
|
contentUrl |
string
O URL do conteúdo da imagem em miniatura. O URL da imagem tem uma vida útil padrão de 30 minutos. Esse URL está associado à conta do solicitante. Qualquer pessoa com o URL acessa a imagem como o solicitante original. O acesso à imagem pode ser perdido se as configurações de compartilhamento da apresentação mudarem. O tipo MIME da imagem em miniatura é o mesmo especificado no GetPageThumbnailRequest.
|
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
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
Para mais informações, consulte o guia de autorização.
ThumbnailProperties
Oferece controle sobre a criação de miniaturas de páginas.
| Campos |
mimeType |
enum (MimeType)
O tipo MIME opcional da imagem em miniatura. Se você não especificar o tipo MIME, o padrão será PNG.
|
thumbnailSize |
enum (ThumbnailSize)
O tamanho opcional da imagem da miniatura. Se você não especificar o tamanho, o servidor vai escolher um tamanho padrão para a imagem.
|
MimeType
O tipo MIME da imagem de miniatura.
| Enums |
PNG |
O tipo MIME padrão. |
ThumbnailSize
Os tamanhos de imagem em miniatura predefinidos.
| Enums |
THUMBNAIL_SIZE_UNSPECIFIED |
O tamanho padrão da imagem em miniatura. O tamanho da miniatura não especificado implica que o servidor escolhe o tamanho da imagem de uma forma que pode variar no futuro. |
LARGE |
A largura da miniatura é de 1600 pixels. |
MEDIUM |
A largura da imagem da miniatura é de 800 px. |
SMALL |
A largura da miniatura é de 200 px. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-03-25 UTC.
[null,null,["Última atualização 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. |"]]
