Method: presentations.pages.getThumbnail

Génère une vignette de la dernière version de la page spécifiée dans la présentation et renvoie une URL vers l'image miniature.

Cette requête est comptabilisée comme une requête de lecture coûteuse à des fins de quota.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
presentationId

string

ID de la présentation à récupérer.
pageObjectId

string

ID d'objet de la page dont la vignette à récupérer.

Paramètres de requête

Paramètres
thumbnailProperties

object (ThumbnailProperties)

Propriétés de la vignette.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Vignette d'une page.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
Champs
width

integer

Largeur positive en pixels de la vignette.
height

integer

Hauteur positive (en pixels) de l'image miniature.
contentUrl

string

URL de contenu de la vignette.

La durée de vie par défaut de l'URL de l'image est de 30 minutes. Cette URL comporte un tag avec le compte du demandeur. Toute personne disposant de l'URL accède à l'image en tant que demandeur d'origine. L'accès à l'image peut être perdu en cas de modification des paramètres de partage de la présentation. Le type MIME de la vignette est identique à celui spécifié dans GetPageThumbnailRequest.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le Guide relatif aux autorisations.

ThumbnailProperties

Permet de contrôler la création des miniatures de page.

Représentation JSON 
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
Champs
mimeType

enum (MimeType)

Type MIME facultatif de l'image miniature.

Si vous ne spécifiez pas de type MIME, il est défini par défaut sur PNG.
thumbnailSize

enum (ThumbnailSize)

Taille de l'image de la vignette facultative.

Si vous n'indiquez pas de taille, le serveur choisit une taille par défaut de l'image.

MimeType

Type MIME de la vignette.

Enums
PNG Type MIME par défaut.

ThumbnailSize

Tailles prédéfinies des vignettes.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Taille par défaut de l'image de la vignette.

La taille de vignette non spécifiée implique que le serveur choisit la taille de l'image de manière susceptible de varier par la suite.
LARGE Largeur de l'image miniature de 1 600 pixels.
MEDIUM Largeur de l'image miniature de 800 pixels.
SMALL Largeur de l'image miniature de 200 pixels.