Method: presentations.pages.getThumbnail
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Genera una miniatura della versione più recente della pagina specificata nella presentazione e restituisce un URL all'immagine in miniatura.
Ai fini della quota, questa richiesta viene conteggiata come richiesta di lettura di costo elevato.
Richiesta HTTP
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
presentationId |
string
L'ID della presentazione da recuperare.
|
pageObjectId |
string
L'ID oggetto della pagina di cui recuperare la miniatura.
|
Parametri di query
| Parametri |
thumbnailProperties |
object (ThumbnailProperties)
Le proprietà delle miniature.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
La miniatura di una pagina.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"width": integer,
"height": integer,
"contentUrl": string
} |
| Campi |
width |
integer
La larghezza positiva in pixel dell'immagine in miniatura.
|
height |
integer
L'altezza positiva in pixel dell'immagine in miniatura.
|
contentUrl |
string
L'URL dei contenuti dell'immagine in miniatura. La durata predefinita dell'URL dell'immagine è di 30 minuti. Questo URL è contrassegnato con l'account dell'utente che ha effettuato la richiesta. Chiunque abbia l'URL accede effettivamente all'immagine come richiedente originale. L'accesso all'immagine potrebbe andare perso se le impostazioni di condivisione della presentazione vengono modificate. Il tipo MIME dell'immagine della miniatura è lo stesso specificato in GetPageThumbnailRequest.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti 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
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
ThumbnailProperties
Offre il controllo sulla creazione delle miniature delle pagine.
| Campi |
mimeType |
enum (MimeType)
Il tipo MIME facoltativo dell'immagine miniatura. Se non specifichi il tipo MIME, il valore predefinito è PNG.
|
thumbnailSize |
enum (ThumbnailSize)
Le dimensioni facoltative dell'immagine miniatura. Se non specifichi le dimensioni, il server sceglie le dimensioni predefinite dell'immagine.
|
MimeType
Il tipo MIME dell'immagine in miniatura.
| Enum |
PNG |
Il tipo MIME predefinito. |
ThumbnailSize
Le dimensioni predefinite delle immagini in miniatura.
| Enum |
THUMBNAIL_SIZE_UNSPECIFIED |
Le dimensioni predefinite delle miniature. Le dimensioni non specificate delle miniature implicano che il server scelga le dimensioni dell'immagine in un modo che potrebbe variare in futuro. |
LARGE |
La larghezza dell'immagine della miniatura deve essere di 1600 pixel. |
MEDIUM |
La larghezza dell'immagine in miniatura deve essere di 800 pixel. |
SMALL |
La larghezza dell'immagine della miniatura deve essere di 200 px. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-03-25 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
