L'API Google Slides vous permet de créer des fichiers de présentation et de gérer les fichiers existants.
Les exemples de cette page présentent certaines opérations de présentation de page courantes à l'aide de la méthode presentations.batchUpdate
.
Ces exemples sont présentés comme des requêtes HTTP afin d'être indépendants du langage. Pour découvrir comment mettre en œuvre une mise à jour par lot dans différents langages à l'aide des bibliothèques clientes de l'API Google, consultez les guides suivants:
- Créer et gérer des présentations
- Rechercher des fichiers et des dossiers
- Fusionner des données dans une présentation
Créer une présentation
L'exemple de code presentations.create
suivant montre comment créer un fichier de présentation vide intitulé "My New Overview" (Ma nouvelle présentation).
Il est également possible de créer des fichiers de présentation vides à l'aide de la méthode files.create
de l'API Google Drive en spécifiant application/vnd.google-apps.presentation
comme type MIME.
Voici le protocole de requête permettant de créer une présentation:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
Lister les fichiers de présentation existants
L'API Slides ne fournit pas de méthode pour récupérer une liste de présentations, contrairement à l'API Drive.
La méthode files.list
(présentée ci-dessous) utilise des masques de champ pour renvoyer une liste de fichiers de présentation à partir de votre Drive, avec l'ID du fichier, son nom et un lien pour l'ouvrir. La requête spécifie également application/vnd.google-apps.presentation
comme type MIME.
Voici le protocole de requête permettant de lister les fichiers de présentation existants:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
La réponse à cette requête présente la structure suivante:
{ "files": [ { "id": "abcdefghijklmnopqrstuvwxyz0123456789", "name": "Project Vision", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk" }, { "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "name": "Untitled Presentation", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk" }, ... ] }
Remplacer du texte dans une présentation
L'exemple de code presentations.batchUpdate
suivant montre comment utiliser la méthode ReplaceAllTextRequest
pour remplacer le texte dans toute la présentation spécifiée par PRESENTATION_ID. Vous pouvez découvrir la valeur de l'ID de présentation à partir de l'URL de la présentation.
Chaque instance de la chaîne "Gizmo Corp." est remplacée par le texte "Gadget Inc.". Cela inclut le texte dans les zones de texte et d'autres formes, sur les diapositives et dans les maîtres. Dans ce cas, le remplacement de texte est sensible à la casse en définissant matchCase
sur true
.
Voici le protocole de requête permettant de remplacer du texte dans une présentation:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }