Method: presentations.pages.getThumbnail

Génère une miniature 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 pour le 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 miniature doit être récupérée.

Paramètres de requête

Paramètres
thumbnailProperties

object (ThumbnailProperties)

Propriétés de la miniature.

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 miniature.
height

integer

Hauteur positive de la miniature en pixels.
contentUrl

string

URL du contenu de l'image miniature.

L'URL de l'image a une durée de vie par défaut de 30 minutes. Cette URL est taguée avec le compte du demandeur. Toute personne disposant de l'URL peut accéder à l'image en tant que demandeur d'origine. Vous risquez de perdre l'accès à l'image si les paramètres de partage de la présentation sont modifiés. Le type MIME de l'image miniature 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 d'autorisation.

ThumbnailProperties

Permet de contrôler la création de miniatures de pages.

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 le type MIME, il est défini par défaut sur PNG.
thumbnailSize

enum (ThumbnailSize)

Taille facultative de l'image miniature.

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

MimeType

Type MIME de la vignette.

Enums
PNG Type MIME par défaut.

ThumbnailSize

Tailles d'image miniature prédéfinies. Les valeurs indiquées ici décrivent la largeur de la miniature. Lorsque la hauteur de la page est supérieure à la largeur, il est possible que la largeur soit inférieure à la taille spécifiée.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Taille par défaut de l'image miniature.

La taille de miniature non spécifiée implique que le serveur choisit la taille de l'image d'une manière qui peut varier à l'avenir.
LARGE Largeur de la vignette de l'image (1 600 px).
MEDIUM La largeur de l'image miniature est de 800 px.
SMALL Largeur de la vignette (200 pixels).