Method: presentations.pages.getThumbnail

Generuje miniaturę najnowszej wersji określonej strony w prezentacji i zwraca adres URL obrazu miniatury.

W związku z tym żądanie to jest liczone jako drogie żądanie odczytu.

Żądanie HTTP

GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
presentationId

string

Identyfikator prezentacji do pobrania.

pageObjectId

string

Identyfikator obiektu strony, z której ma zostać pobrana miniatura.

Parametry zapytania

Parametry
thumbnailProperties

object (ThumbnailProperties)

Właściwości miniatury.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Miniatura strony.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
Pola
width

integer

Dodatnia szerokość obrazu miniatury w pikselach.

height

integer

Dodatnia wysokość obrazu miniatury w pikselach.

contentUrl

string

Adres URL treści obrazu miniatury.

Domyślny adres URL obrazu to 30 minut. Ten adres URL jest otagowany kontem użytkownika zgłaszającego prośbę. Każda osoba, która zna adres URL, uzyskuje dostęp do zdjęcia jako osoba, która przesłała prośbę. Jeśli zmienią się ustawienia udostępniania prezentacji, możesz utracić dostęp do obrazu. Typ MIME obrazu miniatury jest taki sam jak określony w polu GetPageThumbnailRequest.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • 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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

ThumbnailProperties

Zapewnia kontrolę nad tworzeniem miniatur strony.

Zapis JSON
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Pola
mimeType

enum (MimeType)

Opcjonalny typ MIME obrazu miniatury.

Jeśli nie określisz typu MIME, domyślnie zostanie ustawiony format PNG.

thumbnailSize

enum (ThumbnailSize)

Opcjonalny rozmiar miniatury obrazu.

Jeśli nie określisz rozmiaru, serwer wybierze domyślny rozmiar obrazu.

MimeType

Typ MIME obrazu miniatury.

Wartości w polu enum
PNG Domyślny typ MIME.

ThumbnailSize

Wstępnie zdefiniowane rozmiary miniatur.

Wartości w polu enum
THUMBNAIL_SIZE_UNSPECIFIED

Domyślny rozmiar miniatury obrazu.

Nieokreślony rozmiar miniatury oznacza, że serwer wybiera rozmiar obrazu w sposób, który może się zmienić w przyszłości.

LARGE Szerokość obrazu miniatury: 1600 pikseli.
MEDIUM Szerokość obrazu miniatury: 800 pikseli.
SMALL Szerokość obrazu miniatury to 200 pikseli.