Method: presentations.pages.getThumbnail

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

W celu stosowania limitów to żądanie jest uznawane za 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, 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

Pozytywna szerokość miniatury w pikselach.

height

integer

Pozytywna wysokość miniatury w pikselach.

contentUrl

string

Adres URL treści miniatury obrazu.

Adres URL obrazu ma domyślny czas życia 30 minut. Ten adres URL jest oznaczony tagiem konta osoby, która wysłała prośbę. Każdy, kto ma adres URL, ma dostęp do obrazu jako pierwotny żądający. Jeśli ustawienia udostępniania prezentacji ulegną zmianie, możesz utracić dostęp do obrazu. Typ MIME miniatury jest taki sam jak podany w pliku 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 dotyczącym autoryzacji.

ThumbnailProperties

Umożliwia kontrolę nad tworzeniem 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, zostanie użyty domyślny typ MIME 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 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 1600 pikseli.
MEDIUM Szerokość miniatury obrazu 800 pikseli.
SMALL Szerokość miniatury to 200 pikseli.