L'API Google Slides vous permet de créer, de déplacer et de supprimer des diapositives. Les exemples de
cette page montrent certaines opérations courantes sur les diapositives à l'aide de la
presentations.batchUpdate
méthode.
Ces exemples utilisent les variables suivantes :
- PRESENTATION_ID : indique où vous fournissez l' ID de la présentation. Vous pouvez découvrir la valeur de cet ID à partir de l'URL de la présentation.
- PAGE_ID et PAGE_ID2 : indiquent où vous fournissez les ID d'objet de la page. Vous pouvez récupérer la valeur de cet ID à partir de l'URL ou à l'aide d'une requête de lecture d'API.
Ces exemples sont présentés sous forme de requêtes HTTP pour être indépendants du langage. Pour découvrir comment implémenter une mise à jour groupée dans différents langages à l'aide des bibliothèques clientes de l'API Google, consultez les guides suivants : Créer une diapositive et Ajouter des formes et du texte.
Copier une diapositive
L'exemple de code
presentations.batchUpdate
suivant montre comment utiliser la méthode
DuplicateObjectRequest
pour copier une diapositive et l'insérer après l'original dans la présentation.
La diapositive d'origine est spécifiée par PAGE_ID.
La requête vous permet de spécifier si certains ou tous les ID d'élément de page doivent figurer dans la copie (avec certaines restrictions). Dans cet exemple, la diapositive d'origine contient un élément de tableau (spécifié par le TABLE_ELEMENT_ID) qui est mappé à un nouveau tableau (spécifié par le COPY_TABLE_ELEMENT_ID) dans la copie de la diapositive (spécifiée par le COPY_PAGE_ID). Tous les autres éléments de la copie reçoivent des ID aléatoires.
Pour en savoir plus sur la copie d'un
PageElement,
y compris les zones de texte, les images, les tableaux, les formes de base, les lignes et les vidéos intégrées,
consultez l'exemple Copier et modifier un
élément.
Voici le protocole de requête pour copier une diapositive :
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"duplicateObject": {
"objectId": PAGE_ID,
"objectIds": {
"PAGE_ID": "COPY_PAGE_ID",
"TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
}
}
}
]
}Créer une diapositive
L'exemple de code
presentations.batchUpdate
suivant montre comment utiliser la méthode
CreateSlideRequest
pour créer une diapositive et l'insérer en tant que quatrième diapositive (à l'aide de
insertionIndex) dans la présentation.
La nouvelle diapositive est configurée pour utiliser la
PredefinedLayout
de TITLE_AND_TWO_COLUMNS. Vous pouvez spécifier une chaîne à utiliser comme le
PAGE_ID pour la diapositive (avec certaines
restrictions),
ou autoriser l'API à générer le PAGE_ID en omettant le champ
dans la requête.
Voici le protocole de requête pour créer une diapositive :
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createSlide": {
"objectId": "PAGE_ID",
"insertionIndex": 3,
"slideLayoutReference": {
"predefinedLayout": "TITLE_AND_TWO_COLUMNS"
}
}
}
]
}Créer une diapositive et modifier des espaces réservés
L'exemple de code suivant
presentations.batchUpdate
montre comment utiliser la
CreateSlideRequest
méthode pour créer une diapositive à l'aide de la
PredefinedLayout
de TITLE_AND_TWO_COLUMNS.
Vous pouvez spécifier une chaîne à utiliser comme PAGE_ID pour la diapositive
(avec certaines
restrictions).
Le
placeholderIdMappings
utilise le
Type de
TITLE. Le TITLE_ID fait référence à la forme de l'espace réservé de la diapositive
afin qu'elle puisse être modifiée.
Voici le protocole de requête pour créer une diapositive et modifier des espaces réservés :
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
Déplacer des diapositives vers une nouvelle position
L'exemple de code suivant
presentations.batchUpdate
montre comment utiliser la méthode
UpdateSlidesPositionRequest
pour prendre les deux diapositives spécifiées et les déplacer au début de la
présentation, en conservant leur ordre relatif.
Les ID de diapositive spécifiés (PAGE_ID et PAGE_ID2)
doivent être fournis dans l'ordre de présentation existant, sans doublons. insertionIndex basé sur zéro indique où les diapositives doivent être insérées, en fonction de l'ordre avant le déplacement. La valeur doit être comprise entre zéro et le nombre de diapositives de la présentation, inclus.
Voici le protocole de requête pour déplacer des diapositives vers une nouvelle position :
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updateSlidesPosition": {
"slideObjectIds": [
PAGE_ID,
PAGE_ID2
],
"insertionIndex": 0
}
}
]
}Définir une image d'arrière-plan pour une diapositive
L'exemple de code
presentations.batchUpdate
suivant montre comment utiliser la méthode
UpdatePagePropertiesRequest
pour définir l'image d'arrière-plan d'une diapositive spécifiée par le
PAGE_ID. L'API récupère l'image à l'aide de
IMAGE_URL.
Un masque de champ est utilisé pour spécifier que seul l' arrière-plan de la diapositive doit être modifié afin de conserver les autres propriétés. L'utilisation de masques de champ améliore également les performances.
Vous pouvez également utiliser une méthode UpdatePagePropertiesRequest pour définir l'arrière-plan d'une diapositive sur une couleur unie.
Voici le protocole de requête pour définir une image d'arrière-plan pour une diapositive :
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageProperties": {
"objectId": PAGE_ID,
"pageProperties": {
"pageBackgroundFill": {
"stretchedPictureFill": {
"contentUrl": IMAGE_URL
}
}
},
"fields": "pageBackgroundFill"
}
}
]
}Générer une vignette
Vous pouvez générer une vignette de la dernière version d'une page spécifique de la
présentation en appelant la
presentations.pages.getThumbnail
méthode, qui renvoie une image miniature de la page sous forme d'URL de contenu. L'URL de l'image a une durée de vie par défaut de 30 minutes.
Vous pouvez également spécifier les mimeType et thumbnailSize renvoyés à l'aide du
ThumbnailProperties
champ comme paramètre de requête.
Voici le protocole de requête pour générer la vignette de la page avec le ThumbnailProperties défini :
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
"width": 800,
"height": 450,
"contentUrl": "CONTENT_URL"
}