Method: presentations.pages.getThumbnail

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/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

Hier können Sie festlegen, wie Miniaturansichten für Seiten erstellt werden.

JSON-Darstellung 
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
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.