Method: presentations.pages.getThumbnail

Erzeugt eine Miniaturansicht der neuesten Version der angegebenen Seite in der Präsentation und gibt eine URL zur Miniaturansicht zurück.

Diese Anfrage zählt für Kontingentzwecke als teure Leseanfrage.

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 abzurufenden Präsentation.

pageObjectId

string

Die Objekt-ID der Seite, deren Miniaturansicht abgerufen werden soll.

Abfrageparameter

Parameter
thumbnailProperties

object (ThumbnailProperties)

Die Eigenschaften der Miniaturansicht.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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 Thumbnail-Bilds in Pixeln.

height

integer

Die positive Höhe des Thumbnail-Bilds in Pixeln.

contentUrl

string

Die Inhalts-URL der Miniaturansicht.

Die URL für das Bild hat eine Standardlebensdauer von 30 Minuten. Diese URL ist mit dem Konto des Antragstellers getaggt. Jede Person, die über die URL verfügt, greift effektiv als der ursprüngliche Anforderer auf das Bild zu. Möglicherweise verlieren Sie den Zugriff auf das Bild, wenn sich die Freigabeeinstellungen der Präsentation ändern. Der MIME-Typ des Thumbnail-Bilds ist der gleiche wie in GetPageThumbnailRequest angegeben.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

ThumbnailProperties

Sie können festlegen, wie Miniaturansichten der Seite erstellt werden sollen.

JSON-Darstellung
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Felder
mimeType

enum (MimeType)

Der optionale MIME-Typ des Thumbnail-Bilds.

Wenn Sie keinen MIME-Typ angeben, wird standardmäßig PNG als MIME-Typ verwendet.

thumbnailSize

enum (ThumbnailSize)

Die optionale Bildgröße für Miniaturansichten.

Wenn Sie keine Größe 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 Größen der Miniaturansichten

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Die Standardgröße für Miniaturansichten.

Die nicht angegebene Größe der Miniaturansicht impliziert, dass der Server die Größe des Bildes auf eine Weise auswählt, die sich in Zukunft ändern kann.

LARGE Die Breite des Thumbnail-Bilds von 1.600 Pixeln.
MEDIUM Die Breite des Thumbnail-Bilds beträgt 800 Pixel.
SMALL Die Breite des Thumbnail-Bilds von 200 Pixeln.