Method: presentations.pages.getThumbnail

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

To żądanie liczy się jako kosztowne żądanie odczytu ze względu na limity.

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

integer

Dodatnia wysokość obrazu miniatury w pikselach.
contentUrl

string

Adres URL treści obrazu miniatury.

Domyślny czas trwania adresu URL obrazu to 30 minut. Ten adres URL jest oznaczony tagiem konta osoby wysyłającej prośbę. Każda osoba znająca adres URL faktycznie uzyskuje dostęp do obrazu jako osoba, która zgłosiła pierwotne żądanie. Możesz utracić dostęp do obrazu, jeśli zmienią się ustawienia udostępniania prezentacji. Typ MIME obrazu miniatury jest taki sam jak 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

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 będzie to PNG.
thumbnailSize

enum (ThumbnailSize)

Opcjonalny rozmiar obrazu miniatury.

Jeśli nie określisz rozmiaru obrazu, 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 obrazu miniatury.

Wartości w polu enum
THUMBNAIL_SIZE_UNSPECIFIED

Domyślny rozmiar obrazu miniatury.

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