Method: presentations.pages.getThumbnail

Genera una miniatura de la versión más reciente de la página especificada en la presentación y devuelve una URL a la imagen de la miniatura.

A los efectos de la cuota, esta solicitud se considera una solicitud de lectura costosa.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
presentationId

string

Es el ID de la presentación que se recuperará.
pageObjectId

string

Es el ID del objeto de la página cuya miniatura se recuperará.

Parámetros de consulta

Parámetros
thumbnailProperties

object (ThumbnailProperties)

Son las propiedades de la miniatura.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la miniatura de una página.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
Campos
width

integer

Ancho positivo en píxeles de la imagen en miniatura.
height

integer

Altura positiva en píxeles de la imagen en miniatura.
contentUrl

string

Es la URL del contenido de la imagen en miniatura.

La URL de la imagen tiene una vida útil predeterminada de 30 minutos. Esta URL está etiquetada con la cuenta del solicitante. Cualquier persona que tenga la URL accederá a la imagen como el solicitante original. Es posible que se pierda el acceso a la imagen si cambia la configuración de uso compartido de la presentación. El tipo de MIME de la imagen en miniatura es el mismo que se especificó en GetPageThumbnailRequest.

Permisos de autorización

Se necesita uno de los siguientes permisos de 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

Para obtener más información, consulta la Guía de autorización.

ThumbnailProperties

Proporciona control sobre la creación de miniaturas de páginas.

Representación JSON 
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Campos
mimeType

enum (MimeType)

Es el tipo de MIME opcional de la imagen en miniatura.

Si no especificas el tipo de MIME, se usará PNG de forma predeterminada.
thumbnailSize

enum (ThumbnailSize)

Es el tamaño opcional de la imagen en miniatura.

Si no especificas el tamaño, el servidor elegirá un tamaño predeterminado para la imagen.

MimeType

Es el tipo de MIME de la imagen en miniatura.

Enums
PNG Es el tipo de MIME predeterminado.

ThumbnailSize

Son los tamaños de imagen en miniatura predefinidos. Los valores aquí describen el ancho de la imagen en miniatura. Cuando la altura de la página es mayor que el ancho, es posible que el ancho sea menor que el tamaño especificado.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Tamaño predeterminado de la imagen en miniatura.

El tamaño de miniatura no especificado implica que el servidor elige el tamaño de la imagen de una manera que podría variar en el futuro.
LARGE El ancho de la imagen miniatura de 1,600 px.
MEDIUM El ancho de la imagen en miniatura es de 800 px.
SMALL El ancho de la imagen miniatura es de 200 px.