Method: presentations.pages.getThumbnail

Generiert eine Miniaturansicht der aktuellen Version der angegebenen Seite in der Präsentation und gibt eine URL zum Miniaturbild 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.

Suchparameter

Parameter
thumbnailProperties

object (ThumbnailProperties)

Die Eigenschaften der Miniaturansicht.

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 Vorschaubilds 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 Antragstellers getaggt. Jeder, der die URL hat, greift auf das Bild zu, 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 Vorschaubilds ist derselbe wie im 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 Autorisierungsleitfaden.

ThumbnailProperties

Bietet Kontrolle über die Erstellung von Seitenminiaturen.

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

enum (MimeType)

Der optionale MIME-Typ des Vorschaubilds.

Wenn Sie den MIME-Typ nicht angeben, wird standardmäßig PNG verwendet.
thumbnailSize

enum (ThumbnailSize)

Die optionale Größe des Miniaturbilds.

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 Größen für Miniaturansichten. Die Werte hier beschreiben die Breite des Thumbnail-Bildes. Wenn die Seitenhöhe größer als die Breite ist, kann die Breite kleiner als die angegebene Größe sein.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Die Standardgröße für Miniaturansichten.

Wenn die Größe der Miniaturansicht nicht angegeben ist, wählt der Server die Größe des Bildes aus. Das kann sich in Zukunft ändern.
LARGE Die Breite des Vorschaubilds beträgt 1.600 Pixel.
MEDIUM Die Breite des Vorschaubilds beträgt 800 Pixel.
SMALL Die Breite der Miniaturansicht beträgt 200 Pixel.