Method: presentations.pages.getThumbnail
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Er generiert eine Miniaturansicht der neuesten Version der angegebenen Seite in der Präsentation und gibt eine URL zum Miniaturbild zurück.
Diese Anfrage wird für Kontingentzwecke als teure Leseanfrage gezählt.
HTTP-Anfrage
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
presentationId |
string
Die ID der Präsentation, die abgerufen werden soll.
|
pageObjectId |
string
Die Objekt-ID der Seite, deren Miniaturansicht abgerufen werden soll.
|
Abfrageparameter
| Parameter |
thumbnailProperties |
object (ThumbnailProperties)
Die Miniaturansichtseigenschaften.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Die Miniaturansicht einer Seite.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"width": integer,
"height": integer,
"contentUrl": string
} |
| Felder |
width |
integer
Die positive Breite des Thumbnails in Pixeln.
|
height |
integer
Die positive Höhe des Thumbnails in Pixeln.
|
contentUrl |
string
Die Inhalts-URL des Bildes für die Miniaturansicht. Die URL zum Bild hat eine Standardgültigkeitsdauer von 30 Minuten. Diese URL ist mit dem Konto des Anfragenden getaggt. Jeder, der die URL hat, kann auf das Bild zugreifen, als wäre er der ursprüngliche Anfragende. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Präsentation ändern. Der MIME-Typ des Thumbnail-Bilds muss mit dem in GetPageThumbnailRequest angegebenen übereinstimmen.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
ThumbnailProperties
Hier können Sie festlegen, wie Miniaturansichten für Seiten erstellt werden.
| Felder |
mimeType |
enum (MimeType)
Der optionale MIME-Typ des Miniaturbilds. Wenn Sie den MIME-Typ nicht angeben, wird standardmäßig PNG verwendet.
|
thumbnailSize |
enum (ThumbnailSize)
Optionale Größe des Thumbnail-Bilds. Wenn Sie die Größe nicht angeben, wählt der Server eine Standardgröße für das Bild aus.
|
MimeType
Der MIME-Typ des Thumbnail-Bilds.
| Enums |
PNG |
Der Standard-MIME-Typ. |
ThumbnailSize
Die vordefinierten Miniaturansichtsgrößen.
| Enums |
THUMBNAIL_SIZE_UNSPECIFIED |
Die Standardgröße der Miniaturansicht. Wenn die Größe der Miniaturansicht nicht angegeben ist, wählt der Server die Größe des Bildes auf eine Weise aus, die sich in Zukunft ändern kann. |
LARGE |
Die Breite des Miniaturbilds beträgt 1.600 Pixel. |
MEDIUM |
Die Breite des Thumbnail-Bilds beträgt 800 Pixel. |
SMALL |
Die Breite des Miniaturbilds beträgt 200 Pixel. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
