Method: presentations.pages.getThumbnail

Genera una miniatura dell'ultima versione della pagina specificata nella presentazione e restituisce un URL all'immagine in miniatura.

Questa richiesta viene conteggiata come una richiesta di lettura costosa ai fini della quota.

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 dell'oggetto della pagina di cui recuperare la miniatura.

Parametri di query

Parametri
thumbnailProperties

object (ThumbnailProperties)

Le proprietà della miniatura.

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.

L'URL dell'immagine ha una durata predefinita di 30 minuti. Questo URL è codificato con l'account del richiedente. Chiunque abbia l'URL accede effettivamente all'immagine come richiedente originale. Se le impostazioni di condivisione della presentazione cambiano, l'accesso all'immagine potrebbe andare perso. Il tipo MIME dell'immagine in 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

Fornisce 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 in miniatura.

Se non specifichi il tipo MIME, viene usato per impostazione predefinita PNG.

thumbnailSize

enum (ThumbnailSize)

Le dimensioni facoltative dell'immagine in miniatura.

Se non specifichi la dimensione, il server sceglie una dimensione predefinita per l'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 dell'immagine in miniatura.

La dimensione non specificata della miniatura implica che il server scelga la dimensione dell'immagine in un modo che potrebbe variare in futuro.

LARGE La larghezza dell'immagine in miniatura è pari a 1600 px.
MEDIUM La larghezza dell'immagine in miniatura è pari a 800 px.
SMALL La larghezza dell'immagine in miniatura è pari a 200 px.