Method: presentations.pages.getThumbnail

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

Na potrzeby limitu to żądanie jest traktowane jako kosztowne żą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, której miniaturę chcesz pobrać.

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ść miniatury w pikselach.
height

integer

Dodatnia wysokość miniatury w pikselach.
contentUrl

string

Adres URL treści miniatury.

Adres URL obrazu ma domyślny czas życia wynoszący 30 minut. Ten adres URL jest oznaczony tagiem konta osoby wysyłającej żądanie. Każda osoba, która ma ten adres URL, uzyskuje dostęp do obrazu jako pierwotny wnioskodawca. Jeśli ustawienia udostępniania prezentacji ulegną zmianie, dostęp do obrazu może zostać utracony. Typ MIME obrazu miniatury jest taki sam jak podany w polu GetPageThumbnailRequest.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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 po autoryzacji.

ThumbnailProperties

Umożliwia kontrolowanie tworzenia miniatur stron.

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

enum (MimeType)

Opcjonalny typ MIME miniatury.

Jeśli nie określisz typu MIME, domyślnie będzie to PNG.
thumbnailSize

enum (ThumbnailSize)

Opcjonalny rozmiar miniatury.

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

MimeType

Typ MIME miniatury.

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

ThumbnailSize

Wstępnie zdefiniowane rozmiary miniatur. Wartości w tym miejscu określają szerokość miniatury. Gdy wysokość strony jest większa niż jej szerokość, szerokość może być mniejsza niż określony rozmiar.

Wartości w polu enum
THUMBNAIL_SIZE_UNSPECIFIED

Domyślny rozmiar miniatury.

Nieokreślony rozmiar miniatury oznacza, że serwer wybiera rozmiar obrazu w sposób, który może się w przyszłości zmienić.
LARGE Szerokość miniatury obrazu wynosząca 1600 pikseli.
MEDIUM Szerokość miniatury obrazu wynosi 800 pikseli.
SMALL Szerokość miniatury obrazu to 200 pikseli.