Method: presentations.pages.getThumbnail

Генерирует миниатюру последней версии указанной страницы в презентации и возвращает URL-адрес миниатюрного изображения.

Этот запрос считается дорогостоящим запросом на чтение с точки зрения квотирования.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
presentationId

string

Идентификатор презентации, которую необходимо получить.

pageObjectId

string

Идентификатор объекта страницы, миниатюру которой необходимо получить.

Параметры запроса

Параметры
thumbnailProperties

object ( ThumbnailProperties )

Свойства миниатюры.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Миниатюра страницы.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
Поля
width

integer

Положительная ширина в пикселях миниатюрного изображения.

height

integer

Положительная высота в пикселях миниатюрного изображения.

contentUrl

string

URL-адрес содержимого миниатюрного изображения.

URL-адрес изображения имеет срок действия по умолчанию 30 минут. Этот URL-адрес помечен учетной записью запрашивающего пользователя. Любой, у кого есть этот URL-адрес, фактически получает доступ к изображению от имени первоначального запрашивающего пользователя. Доступ к изображению может быть потерян, если изменятся настройки общего доступа к презентации. MIME-тип миниатюрного изображения совпадает с указанным в GetPageThumbnailRequest .

Области полномочий

Требуется один из следующих диапазонов аутентификации 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

Для получения более подробной информации см. руководство по авторизации .

Свойства миниатюр

Предоставляет возможность управлять созданием миниатюр страниц.

JSON-представление
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Поля
mimeType

enum ( MimeType )

Необязательный MIME-тип изображения-миниатюры.

Если тип MIME не указан, по умолчанию используется формат PNG.

thumbnailSize

enum ( ThumbnailSize )

Необязательный размер миниатюрного изображения.

Если размер не указан, сервер выбирает размер изображения по умолчанию.

MIME-тип

MIME-тип миниатюрного изображения.

Перечисления
PNG Тип MIME по умолчанию.

Размер миниатюры

Заданные размеры миниатюрных изображений. Значения здесь описывают ширину миниатюрного изображения. Если высота страницы больше ширины, ширина может быть меньше указанного размера.

Перечисления
THUMBNAIL_SIZE_UNSPECIFIED

Размер миниатюрного изображения по умолчанию.

Неуказанный размер миниатюры подразумевает, что сервер выбирает размер изображения способом, который может измениться в будущем.

LARGE Ширина миниатюрного изображения составляет 1600 пикселей.
MEDIUM Ширина миниатюрного изображения составляет 800 пикселей.
SMALL Ширина миниатюрного изображения составляет 200 пикселей.