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 considéré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 doit être récupérée.

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 de l'image miniature, en pixels.
height

integer

Hauteur positive de l'image miniature, en pixels.
contentUrl

string

URL de contenu de la vignette.

Par défaut, l'URL de l'image a une durée de vie de 30 minutes. Cette URL est associée au compte du demandeur. Toute personne disposant de l'URL accède effectivement à l'image en tant que demandeur initial. L'accès à l'image risque d'être perdu si les paramètres de partage de la présentation sont modifiés. 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 de la vignette.

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

enum (ThumbnailSize)

La taille d'image de la vignette (facultative).

Si vous ne spécifiez pas de taille, le serveur choisit une taille par défaut pour l'image.

MimeType

Type MIME de l'image miniature.

Enums
PNG Type MIME par défaut.

ThumbnailSize

Tailles d'image prédéfinies pour les vignettes.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Taille par défaut de l'image miniature.

Si la taille de la vignette n'est pas spécifiée, le serveur doit choisir la taille de l'image d'une façon qui pourra varier à l'avenir.
LARGE La largeur de l'image de la vignette est de 1 600 pixels.
MEDIUM La largeur de l'image de la vignette est de 800 pixels.
SMALL La largeur de l'image de la vignette est de 200 pixels.