Method: presentations.pages.getThumbnail

Genera una miniatura de la última versión de la página especificada en la presentación y muestra una URL a la imagen en miniatura.

Esta solicitud cuenta como una solicitud de lectura costosa para fines de cuota.

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 de acceso

Parámetros
presentationId

string

El ID de la presentación que se recuperará.

pageObjectId

string

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

Parámetros de consulta

Parámetros
thumbnailProperties

object (ThumbnailProperties)

Las propiedades de las miniaturas.

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

El ancho positivo en píxeles de la imagen en miniatura.

height

integer

Es la 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 puede acceder a la imagen como el solicitante original. Si cambia la configuración de uso compartido de la presentación, es posible que se pierda el acceso a la imagen. El tipo de MIME de la imagen en miniatura es el mismo que se especifica en el GetPageThumbnailRequest.

Alcances 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

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

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

enum (MimeType)

El tipo MIME opcional de la imagen en miniatura.

Si no especificas el tipo de MIME, el tipo MIME se establece de forma predeterminada en PNG.

thumbnailSize

enum (ThumbnailSize)

El tamaño opcional de la imagen en miniatura.

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

MimeType

El tipo MIME de la imagen en miniatura.

Enumeraciones
PNG El tipo de MIME predeterminado.

ThumbnailSize

Los tamaños de imagen en miniatura predefinidos

Enumeraciones
THUMBNAIL_SIZE_UNSPECIFIED

El 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 en miniatura es de 1600 px.
MEDIUM El ancho de la imagen de la miniatura es de 800 px.
SMALL El ancho de la imagen en miniatura es de 200 px.