Method: presentations.pages.getThumbnail

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

Esta solicitud se considera una solicitud de lectura costosa a los efectos de la 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

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)

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

Es el ancho positivo en píxeles de la imagen de la miniatura.

height

integer

Es la altura positiva en píxeles de la imagen de 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 accede 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 de miniatura es el mismo que se especifica 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 de miniatura.

Si no especificas el tipo MIME, el valor predeterminado es PNG.

thumbnailSize

enum (ThumbnailSize)

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

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

MimeType

Es el tipo de MIME de la imagen de miniatura.

Enumeraciones
PNG Es el tipo MIME predeterminado.

ThumbnailSize

Los tamaños de imagen en miniatura predefinidos.

Enumeraciones
THUMBNAIL_SIZE_UNSPECIFIED

Es 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 miniatura es de 1,600 px.
MEDIUM El ancho de la imagen de la miniatura debe ser de 800 px.
SMALL El ancho de la imagen miniatura es de 200 px.