Method: presentations.pages.getThumbnail

Generiert 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)

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 der Miniaturansicht in Pixeln.

height

integer

Die positive Höhe der Miniaturansicht 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. Jeder, der über die URL verfügt, kann als ursprünglicher Anforderer auf das Bild zugreifen. Der Zugriff auf das Bild kann verloren gehen, wenn die Freigabeeinstellungen der Präsentation geändert werden. Der MIME-Typ der Miniaturansicht ist derselbe 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

Bietet Kontrolle über die Erstellung von Miniaturansichten für Seiten.

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

enum (MimeType)

Der optionale MIME-Typ der Miniaturansicht.

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

thumbnailSize

enum (ThumbnailSize)

Die optionale Größe des Thumbnail-Bilds.

Wenn Sie keine Größe angeben, wählt der Server eine Standardgröße für das Bild aus.

MimeType

Der MIME-Typ des Thumbnails.

Enums
PNG Der Standard-MIME-Typ.

ThumbnailSize

Die vordefinierten Bildgrößen für Miniaturansichten.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Die Standardgröße für Miniaturansichten.

Die nicht angegebene Größe der Miniaturansicht deutet darauf hin, dass der Server die Größe des Bildes auf eine Weise auswählt, die in Zukunft variieren kann.

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