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 de vignette.

Dans le cadre des quotas, cette requête compte comme une requête de lecture coûteuse.

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 de l'objet de la page dont vous souhaitez récupérer la miniature.

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

Miniature 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 l'image miniature.
height

integer

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

string

URL du contenu de l'image miniature.

La durée de vie par défaut de l'URL de l'image est de 30 minutes. Cette URL est taguée avec le compte de la personne à l'origine de la demande. Toute personne disposant de l'URL accède à l'image en tant que demandeur d'origine. L'accès à l'image peut être perdu si les paramètres de partage de la présentation changent. 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 vignettes 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, le type MIME par défaut est PNG.
thumbnailSize

enum (ThumbnailSize)

Taille facultative de l'image miniature.

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 miniature prédéfinies.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

Taille de l'image miniature par défaut.

La taille de la miniature non spécifiée implique que le serveur choisit la taille de l'image de manière à pouvoir la modifier à l'avenir.
LARGE Largeur de l'image de la vignette de 1 600 px.
MEDIUM Largeur de l'image miniature de 800 px.
SMALL Largeur de l'image miniature de 200 pixels.