Method: presentations.pages.getThumbnail

Genera una miniatura della versione più recente della pagina specificata nella presentazione e restituisce un URL all'immagine in miniatura.

Ai fini della quota, questa richiesta viene conteggiata come richiesta di lettura di costo elevato.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
presentationId

string

L'ID della presentazione da recuperare.

pageObjectId

string

L'ID oggetto della pagina di cui recuperare la miniatura.

Parametri di query

Parametri
thumbnailProperties

object (ThumbnailProperties)

Le proprietà delle miniature.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La miniatura di una pagina.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
Campi
width

integer

La larghezza positiva in pixel dell'immagine in miniatura.

height

integer

L'altezza positiva in pixel dell'immagine in miniatura.

contentUrl

string

L'URL dei contenuti dell'immagine in miniatura.

La durata predefinita dell'URL dell'immagine è di 30 minuti. Questo URL è contrassegnato con l'account dell'utente che ha effettuato la richiesta. Chiunque abbia l'URL accede effettivamente all'immagine come richiedente originale. L'accesso all'immagine potrebbe andare perso se le impostazioni di condivisione della presentazione vengono modificate. Il tipo MIME dell'immagine della miniatura è lo stesso specificato in GetPageThumbnailRequest.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti 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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ThumbnailProperties

Offre il controllo sulla creazione delle miniature delle pagine.

Rappresentazione JSON
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Campi
mimeType

enum (MimeType)

Il tipo MIME facoltativo dell'immagine miniatura.

Se non specifichi il tipo MIME, il valore predefinito è PNG.

thumbnailSize

enum (ThumbnailSize)

Le dimensioni facoltative dell'immagine miniatura.

Se non specifichi le dimensioni, il server sceglie le dimensioni predefinite dell'immagine.

MimeType

Il tipo MIME dell'immagine in miniatura.

Enum
PNG Il tipo MIME predefinito.

ThumbnailSize

Le dimensioni predefinite delle immagini in miniatura.

Enum
THUMBNAIL_SIZE_UNSPECIFIED

Le dimensioni predefinite delle miniature.

Le dimensioni non specificate delle miniature implicano che il server scelga le dimensioni dell'immagine in un modo che potrebbe variare in futuro.

LARGE La larghezza dell'immagine della miniatura deve essere di 1600 pixel.
MEDIUM La larghezza dell'immagine in miniatura deve essere di 800 pixel.
SMALL La larghezza dell'immagine della miniatura deve essere di 200 px.