Method: presentations.pages.getThumbnail

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

Diese Anfrage wird als teure Leseanfrage für Kontingentzwecke 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 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

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

Positive Breite des Thumbnail-Bilds in Pixeln.

height

integer

Positive Höhe des Thumbnail-Bilds in Pixeln.

contentUrl

string

Die Content-URL der Miniaturansicht.

Die URL des Bildes hat standardmäßig eine Lebensdauer von 30 Minuten. Diese URL ist mit dem Konto des Antragstellers getaggt. Jede Person mit der URL greift effektiv auf das Bild als ursprünglichen Anforderer zu. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Präsentation ändern. Der MIME-Typ des Thumbnail-Bilds ist mit dem in GetPageThumbnailRequest angegebenen identisch.

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.

Miniaturansichten

Mit dieser Richtlinie wird die Erstellung von Miniaturansichten für Seiten gesteuert.

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

enum (MimeType)

Der optionale MIME-Typ des Thumbnail-Bilds.

Wenn Sie den MIME-Typ nicht angeben, wird er standardmäßig auf PNG gesetzt.

thumbnailSize

enum (ThumbnailSize)

Optionale Bildgröße für das Thumbnail.

Wenn Sie die Größe nicht festlegen, wählt der Server eine Standardgröße des Bildes aus.

MimeType

Der MIME-Typ des Thumbnail-Bilds.

Enums
PNG Der Standard-MIME-Typ.

Miniaturansicht-Größe

Die vordefinierten Bildgrößen der Miniaturansicht.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Dies ist die Standardgröße für Miniaturansichten.

Dies bedeutet, dass der Server die Größe des Bildes auf zukünftige Weise auswählt.

LARGE Die Breite der Miniaturansicht von 1.600 px.
MEDIUM Die Breite des Thumbnail-Bilds mit 800 px.
SMALL Die Breite des Thumbnail-Bilds mit 200 px.